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START HERE ! 


This binder contains everything you need to know about installing 
XENIX and running XENIX programs. 

© Before You Begin: 

1 - Check Appendix A of the Release Notes 

in this binder before making any hardware 
modifications to your system. 

2 - Read the “Installation Notes” in the Release 

Notes. 

3 - Glance through Chapter2, “Installation Procedure,” 

in the Installation Guide , also in this binder. Then, 
use that chapter to help you install XENIX. 

v$>- 


• If you’ve never used XENIX, refer to the Introduction To XENIX 
in this binder. It shows you how to use some of the basic XENIX 
commands. 

• The Release Notes contain important information about your 
system. Refer to them if you have any questions. 

® For information on operating your system, including how to add 
terminals, line printers and other devices, and perform system 
backups, see the Operations Guide. 
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1. Preface 

This document contains information about features and programs of 
XENIX-86 and XENIX-286 System V Release 2.1.3 Operating 
System for personal computers. Please read through this entire 
document before installing the XENIX operating system. 

We are always pleased to hear of user’s experience with our product, 
and recommendations of how it can be made even more useful. All 
written suggestions are given serious consideration. 


2. IMPORTANT NOTES ABOUT INSTALLATION 

V 

Please refer to the Installation Guide in the binder marked “XENIX 
Operating System Run Time Environment ” to install -the XENIX 
Operating System. If you have purchased all three systems, (XENIX 
Operating System, Development System and Text Processing 
System) you can use the XENIX Installation Guide to install them all 
at once. If you wish to install the Development System and/or the 
Text Processing System at a later time, refer to the Release Notes at 
the beginning of the appropriate guide (XENIX Programmer's Guide 
Volume I or XENIX Text Processing Guide). See also the manual 
page for custom(C). custom allows you to install all or portions of 
the XENIX System. Read the Release Notes and Installation Guide in 
their entirety and make sure you completely understand the 
installation process before installing the product. 

It is not advisable to abort the installation process (for example, by 
using the DEL or Ctrl-\ keys). If you need to stop, for example, 
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because you enter incorrect information, start the process again 
from the beginning rather than trying to proceed from the stopping 
point. 

The systems are delivered on these floppies: 


XENIX Operating System 

-volumes N1-N5 
-volumes N1-N2 
-volumes B1-B3 
-volume B1 
-volumes X1-X7 
-volumes X1-X2 

(48tpi) 

(96tpi)* 

(48tpi) 

(96tpi)* 

(48tpi) 

(96tpi)* 

Optional: 

XENIX Development System 

-volumes Dl-Dll 
-volumes D1-D4 

(48tpi) 

(96tpi)* 

Optional: 

XENIX Text Processing System 

-volumes T1-T4 
-volumes T1-T2 

(48tpi) 

(96tpi)* 

Optional: 

Games 

-volume 1 

(48tpi) 


* Availble for 286 AT machines. 


Note 

Users upgrading their XENIX 3.0 system to XENIX System 
V should refer to Appendix B “Upgrading to XENIX 
System V,” later in these Release Notes . Users installing 
XENIX for the first time can ignore the Upgrade appendix. 


XG86/286-6-20-86-3.0/2.1.3 - 2- The Santa Cruz Operation 


Operating System Release Notes 

If you use custom(C) to install the single file /xenix (the XENIX 
kernel) you must serialize the kernel by hand. This is done with the 
command : 

/etc/brand serialnumber activationkey /xenix 

If you do not do this, the kernel will boot with a very limited number 
of processes. 

2.1 Choosing Swap Area 

While installing XENIX System V you are prompted to allocate the 
amount of swap area you want. If you do not specify the number of 
blocks of swap area you want, you are automatically given a default 
amount. This default is minimal. Due to the difficulty in increasing 
your swap area, it is recommended that you ask for the upper limit 
amount shown by the divvy (C) program, if you are planning to use 
large applications (like databases or spreadsheet programs), use the 
software development set extensively, or make many programs 
“sticky” for performance reasons. For more information see 
Chapter 7, “Using Peripheral Devices”, of the Operations Guide and 
Chapter 2, “Installation Procedure”, of the Installation Guide . 


3. Compatible Software 

^ . ’ 

The following software application packages are available from 
The Santa Cruz Operation for use with XENIX. 



SCOFoxBASE™ 

SCO Professional™ 
Informix® 

LEVEL II COBOL™ 

Lyrix™ 

Multiplan® 

uniPATH™ SNA-3270 


Relational Database Management System 
Electronic Spreadsheet 
Relational Database Management System 
Mainframe Level Implementation of the 
business programming language 
Word Processing System 
Electronic Worksheet 
SNA Mainframe 
Communications Package 
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Call your local dealer or The Santa Cruz Operation for more 
information and for availability of the following software application 
packages: 

Microsoft Networks for XENIX PC network compatible LAN 
UX-Basic® BASIC Interpretive Compiler 


Your local dealer may also have the following software which users 
have been able to run on XENIX System V for personal computers: 

Microsoft Pascal 3.3 for XENIX-286 
Microsoft FORTRAN 3.3 for XENIX-286 
RM Fortran VI. 1 for XENIX-286 
RM Cobol V2.1a for XENIX-86 or XENIX-286 


4. Features of the 2.1.3 Release 

This section relates important features of the XENIX operating 
system. 

4.1 Autoboot 

When your computer is turned on, it can go through all boot stages 
automatically. Refer to the autoboot(M) manual page for 
information on configuring your system to autoboot. 

4.2 Binary Compatibility 

This section briefly discusses the types of binaries that are known to 
run on XENIX for personal computers. See the manual page 
machine(M) for a more complete listing of binary compatibility. 


4.2.1 XENIX 2.3 Binary’ Compatibility 

The system can execute most Microsoft XENIX version 2.3 80S6, 
split i/d (instruction/data), x.out format binaries (for example, Altos 
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586 or Intel 86/310/330 binaries). Use of Altos specific system calls is 
not supported. 

4.2.2 XENIX 3.0 Binary Compatibility 

The system can execute Microsoft XENIX version 3.0 8086, split i/d 
(instruction/data), x.out format binaries (for example, Altos 586 or 
Intel 86/310/330 binaries). Use of Altos specific system support calls 
is not supported. 

4.2.3 XENIX System V Binary Compatibility 


The binaries produced by the XENIX C compiler will run on SCO 
XENIX-286, XENIX-186, and XENIX-86 Systems, as well as 
Microsoft 286 XENIX 3.0 or System V and IBM XENIX 3.0 or System 

Machines with SCO XENIX-286 installed can run Microsoft or IBM 
286 XENIX 3.0 or System V binaries . 

4.3 Configurable Console Keyboard and Screen 


XENIX System V Release 2.1.3 supports console keyboard and 
console screen reconfiguration. You can reconfigure the keyboard 
for a different keytop layout, or program some keys, including 
function keys, to send strings of characters. 


You can map characters so that, on output, they display as 
international or graphics characters. For example, you can map “e” 
Refer to the console(M), keyboard(M), 


to display as “e. 
mapkey(M), and setkey(M) manual pages in the XENIX Reference 
for information on configuring the console keyboard. 




/usr/lib/keyboard and /usr /lib /console contain files for British 
English (UK) and German keyboard layouts and screen mapping. 

Refer to section 7.1 “console (M)” for more information on the 
console. 
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4.4 DOS Support 

XENIX supports the coexistence of MS™-DOS and XENIX on the 
same hard disk. However, ITT DOS releases previous to 3.10 
cannot share the disk with XENIX or MS-DOS. For these releases, 
XENIX, or a combination of XENIX and MS-DOS must occupy the 
whole disk on the ITT machines. 


4.4.1 DOS Installation 

For more information, consult Chapter 3 of the XENIX Installation 
Guide and the manual entries for fdisk(C), diwy(C), and dos(C). 
The fdisk(C) and diwy(C) utilities create and change multiple disk 
partitions, allowing separate XENIX and DOS partitions. fdisk(C) 
has similar functionality to the DOS utility of the same name. The 
utilities mentioned in dos(C) allow access to DOS files on the hard 
disk and floppy diskettes. 

Should you decide to install XENIX and DOS on the same hard disk, 
be sure to reserve a sufficiently large partition for XENIX. 


Note 

The minimal XENIX System configuration you can install 
requires approximately 2000 IK blocks, or 2M bytes. The 
entire XENIX System (XENIX Operating System, XENIX 
Development System and XENIX Text Processing System) 
requires approximately 12,000 IK blocks, or 12M bytes. 
Refer to the manual page custom(C) for information on 
installing or removing portions of the XENIX System. 
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It is recommended that DOS be installed on the hard disk before 
installing XENIX. Installing DOS after XENIX, in some 
circumstances, changes the fdisk table making the XENIX partition 
unbootable. (DOS fdisk reports disk size in cylinders, XENIX fdisk 
reports disk size in tracks.) If this happens, you must recreate the 
fdisk table. Boot XENIX from a Bootable XENIX floppy or use the 
Installation BOOT floppy. Run XENIX fdisk(C), delete the XENIX 
partition, then create the XENIX partition exactly as it was before 
DOS was installed. If you use the Installation BOOT floppy, delete 
from the installation procedure after you have run fdisk, and reboot 
the computer. The XENIX partition is once again bootable. 

If you want to install XENIX and DOS on two hard disks refer to the 
chapter “Using XENIX and DOS on the Same Hard Disk” in the 
XENIX Installation Guide and the section titled “Adding a Second 
Hard Disk” in the chapter “Using Peripheral Devices” in the XENIX 
Operations Guide . Also, refer to the XENIX Reference manual pages 
forfdisk(C), mount(C), and mkfs(C). 

4.4.2 DOS Devices 


The following hard disk devices are new in XENIX System V: 

/dev/hdOd 

/dev/rhdOd 

/dev/hdld 

/dev/rhdld 

These devices are similar to /dev/hdOa in that the disk driver 
determines which partition is the DOS partition and uses that as 
hd?d . This means that software using the DOS partition does not 
need to know which partition is DOS (the disk driver determines 
that). 

The file I etc! default Imsdos is an easily configurable file that aliases 
default device names used by the dos(C) commands. For example, it 
now contains the lines: 

C=/dev/hdOd > ' 

D=/dev/hdld 
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Users using the dos(C) utilities can specify “C:” or “D:” on the 
command line, referring to the DOS partition on the first or second 
hard disk. For a complete description on using /etc/default/msdos 
see the manual page dos(C) in the XENIX Reference . 

The XENIX Development System supports the creation of DOS 
executable files, using cc(CP). Refer to the XENIX C User's Guide 
and C Library Guide for information on using XENIX to create 
programs suitable for DOS systems. 

4.4.3 Booting DOS and XENIX 

As noted in section 4.4.1, “DOS Installation”, it is recommended 
that DOS be installed on the hard disk before installing XENIX. This 
can be done in two ways. 

The preferred method for booting the first DOS partition found on 
the disk is to type the word “dos” at the boot prompt. 

Boot 
: dos 

This boots but does not activate the DOS partition. 

If your DOS applications need to run on an active DOS partition, 
you must recreate the XENIX fdisk table. To do this, use the method 
described in section 4.4.1. 

4.5 Games Support 

Use custom(C) to install your Games floppy: 

1. Type custom. 

2. Select the option to “Add a Supported Product.” 

3. Insert Games Volume 1 when prompted. 

Refer to the custom(C) manual page in the XENIX Reference Manual 
for more information on installing all or parts of the games package. 


XG86/286-6-20-86-3.0/2.1.3 -8- The Santa Cruz Operation 


Operating System Release Notes 


4.6 8087 and 80287 Support 

Your personal computer may include the 8087 or 80287 math co- 
processor, which is supported by XENIX-86 and XENIX-286. Please 
note that switches on the main system board must be set properly to 
enable 8087 or 80287 interrupts. Check your hardware manual for 
the proper switch settings. 

At boot time, XENIX will display “math coprocessor present” if an 
8087 or 80287 is detected . 

Some 8087 and 80287 exceptions have been masked. Refer to the 
manual page for 8087(M). 

4.7 Link Kit 

A Link Kit is provided with the XENIX Operating System. The Link 
Kit enables you to add device drivers to your system. Additional 
device drivers are necessary to run non -supported peripheral 
devices. Refer to Chapter 4 of the XENIX Installation Guide, 
“Installing Device Drivers”, for information about using the Link 
Kit. 

In addition, the XENIX C User’s Guide contains two chapters that 
discuss “Writing Devices Drivers,” and “Sample Device Drivers.” 
Also, the Link Kit files themselves include useful instructions and 
examples (including a driver for real-time clocks). Be sure to read 
the text files (especially the README file) in the directory 
/usr/sys/conf if you intend to use the Link Kit. 

You may request up to 202 buffers when using the Link Kit with 
XENIX-286. XENIX-86 has no limit to the number of buffers you can 
request, but it is possible to create more buffers than available 
memory. If this happens XENIX will not boot. 

In order to save disk space, do not install the Link Kit files unless you 
intend to use them. The kernel contains the data space necessary for 
installing device drivers in this 2.1.3 release. custom(C) should be 
used to install (or remove) the Link Kit files. 
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Available kernel data space (needed to link in large or multiple 
device drivers) has been increased in the 2.1.3 release. Device 
drivers which previously did not lit into XENIX might now. 

4.8 Memory Limitations 

Some utilities may not run on systems with less than 512 Kilobytes(K) 
of main memory. vsh(C) (the Microsoft visual shell) and vi(C) (the 
Berkeley full-screen editor) are examples of these. When you invoke 
a utility that needs more memory than available, the message 
“Killed” displays on your screen. If your system has 384K of main 
memor>' we recommend using XENIX with only one screen enabled. 
Multi-user mode will function, but performance suffers, with 384K 
memory. 

vi(C) and vsh(C) are supported for machines with 512K of main 
memory or greater. Use of any medium model programs may 
severely impair system performance with less than 512K of main 
memory. 

We recommend using the XENIX Development System only on 
machines with 5 12K of main memory or greater. 

4.9 mkdev(C) 

The XENIX Operating System now allows you to add additional 
filesystems more easily by using the fs option with mkdev(C). See the 
manual page for mkdev(C) included with these Release Notes, 
Chapter 2 “Installation Procedure” in the XENIX Installation Guide, 
and Chapter 7 “Using Peripheral Devices” in the XENIX Operations 
Guide. 

4.10 Multiscreen™ and Color Support 

The system monitor under XENIX can act as a console and up to 9 
alternate terminals, each of which can support different activities 
(see the manual pages for console(M) and multiscreen(M) in the 
XENIX Reference, and the chapter “Using Peripheral Devices” in the 
XENIX Operations Guide). 
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Note 

The number of screens available depends on the amount 
of memory in your computer, and is displayed when the 
system boots. The actual number of screens enabled is 
user configurable. See enable(C) to use the available 
screens. 

When error messages from the XENIX kernel appear, they 
display on the console screen. When this happens the 
console screen displays instead of the current screen. 


If you have a color monitor you can use the XENIX setcolor(C) utility 
to select the foreground, background, and graphics screen colors 
from a palette of 16 colors (see the manual page for setcolor(C) in the 
XENIX Reference). 

4.11 System V sh shell 

System V sh shell is now the supported shell on the XENIX System V 
Operating System. It is found in Ibinlsh and invoked as sh. Previous 
releases have included, but not supported System V sh shell. 

It has the same functionality as System 3 sh shell, which it has 
replaced, with the following additions: 

shell functions 
MAILCHECK parameter 
MAILPATH parameter 
SHACCT parameter 
SHELL parameter 

input/output redirection for special commands 
hash special command 
pwd special command 
return special command 

See the sh(C) manual page in the XENIX Reference Manual , for more 
information on the System V sh shell. 
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4,12 Software Reboot 

XENIX System V allows software rebooting. You need not power off 
to reboot. The following message is displayed after a system 
shutdown: 


** Safe to Power Off ** 

-or- 

** Hit Any Key to Reboot ** 

Fixed disk heads are “parked” (locked) when this message is 
displayed. 


Note 

When the floppy drive door is closed, the computer 
attempts to boot from a floppy. The floppy drive door 
must be open to boot off the hard disk. 
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4.13 SVID Conformance Notes 

XENIX-286 meets the System V Interface Definition (SVID) 
published in 1985 by AT&T (Select Code 307-127). XENIX System 
V has been subjected to a stringent set of tests for the purpose of 
verifying conformance to SVID. SCO XENIX System V conforms to 
SVID functionality with the following exceptions: 


Function SVID SCO XENIX 

Specification Implementation 

shmat Allows non-zero shmaddr argument must be zero. 

arguments. The SVID states that shmat() should 

allow a non-zero shmaddr 
argument. The segmented 
architecture of the 86 family 
precludes allowing attachment of 
shared memory at specific physical 
addresses. Because of this, SCO 
XENIX requires that the shmaddr 
argument be zero to allow the system 
to choose the first available address. 


shmop Shared memory Because of the architecture of the 
shmctl operations. Return 86 family of chips, SCO XENIX 
shmget “char *shmaddr” chose to implement shared memory 

by using far pointers. The SVID 
“char *shmaddr” is replaced with 
“char far *shmaddr.” This is for the 
same reason as listed for shmat 
above. 




ptrace Address specified Address specified as structure * 
as(int*). The SVID states that ptraceQ calls 

should fail if the ‘addr’ argument is 
not the start address of a word. 
Because of word alignment 
conventions in the 86 family of chips 
this failure will not occur. 
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These exceptions are found on the termio manual pages 
(termio(dev) for SVID and termio(M) for XENIX): 


Termio 

SVID 

SCO XENIX V 

Characters/values 

Specification 

Implementation 

QUIT 

Ctrl-| 

Ctrl-\ 

ERASE 

# 

Ctrl-H 

KILL 

@ 

Ctrl-U 

cjcc value 

7 SWTCH 

not included 

38400 baud 

B3S400 

not included 

Block layer 

LOBLK 

not included 

output - hardware 



control 



default initial 

B300 

B9600 

baud rate 



ISIG causes input 

INTR, SWTCH 

INTR and QUIT 

characters to be 

and QUIT 


checked against 




The c_cc value of SWTCH, the block layer output value of LOBLK, 
and ISIG checking against SWTCH are all related to the 
implementation of job control. XENIX System V Release 2.1.3 does 
not support job control. 

4.14 Ulimit 

The maximum file size, as specified by ulimit(S), is easily adjusted 
upward. The login (M) utility checks the file /etc/default/login for the 
default ulimit size. Refer to the manual pages for default(M), 
login(M), and ulimit(S). 
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5. Hardware Notes 

This section contains notes relating to hardware issues. 

In general, your hardware configuration must have the original 
settings and boards before you bool XENIX. If you have added any 
boards, make sure that till switches are set as recommended in the 
manufacturer’s hardware manual for that board. These guidelines 
must be followed to ensure proper system performance. 

XENIX must boot from the physical drive 0 (the internal hard disk). 
5.1 Adding Another Hard Disk 

Check the section “Add On Hard Disks” and “Compatible Disk 
Controllers” in Appendix A of these Release Notes to see that the 
disk you wish to add works with the XENIX system. You should also 
read the cn tire Release Notes before adding another hard disk. 

The following steps show you how to add an additional hard disk to 
your system. This procedure describes the most straight forward 
configuration: An additional disk consisting of a single XENIX 
partition with one filesystem attached to a system on which XENIX is 
already installed. 

1. Connect the hard disk to your computer. 

2. Make sure the hard disk is formatted to have an operating 
system installed on it. Since this procedure varies, follow the 
manufacturer’s instructions for preparing the disk. 

3. You should already have installed XENIX on your primary, 
or “boot” drive. 


XGS6/286-6-20-86-3.0/2. L.3 - 15- The Santa Cruz Operation 


XENIX for personal computers 


4. After installing XENIX, enter system maintenance mode and 
enter this command: 

/etc/mkdev lid 

mkdev(C) runs hdinit(C) which, in turn invokes fdisk(C), 
badtrk(M) and diwy(C). 

For more information on hdinit(C) see the XENIX 
Reference . 

5. fdisk partitions the disk between operating systems so that 
you can have XENIX partitions, with other areas of the disk 
reserved for DOS. In order to actually create a DOS 
partition, though, you must also run fdisk under DOS. 

When fdisk starts you see this menu: 

Select one of the following options or ‘q’ to exit the program 

1. Display Partition Table 

2. Use Entire Disk for XENIX 

3. Create XENIX Partition 

4. Activate XENIX Partition 

5. Delete XENIX Partition 

Please enter your choice: 

If you want to use your whole disk for XENIX, enter 
“2”, then press RETURN, fdisk displays a table in 
which the entire disk is allocated as a single partition: 


Partition 

Status 

Type 

Start 

End 

Size 

1 

Inactive 

XENIX 

1 

25546 

25546 


Total disk size: 25546 

* '* 

Press <RETURN> to continue 
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Press RETURN, and you see the main fdisk menu. The 
program then prompts for a RETURN to continue. 
After you press RETURN, you see the main fdisk 
menu, shown above. Enter “q” to leave fdisk and 
continue. 

For more information, see fdisk(C) in the XENIX 
Reference . 

6. badtrk is used to scan the XENIX partition for flaws. It 
displays this menu: 


Select one of the following options, or ‘q’ to exit program: 

1. Print Current Bad Track Table 

2. Scan Media Surface for Possible Bad Spots 

3. Create New Bad Track Table 

4. Add Entries to Current Bad Track Table by Head/Cylinder # 

5. Add Entries to Current Bad Track Table by Block Number 

6. Delete Entries from Bad Track Table. 

Please enter your choice: 


Enter “2,” then press RETURN. The program now 
scans the active partition of the new disk for flaws. The 
larger your disk , the longer the scanning process takes, 
so a very large disk may take a while. Common times 
are between one and two minutes per megabyte of 
storage. 

As badtrk scans the disk, it displays the number of 
each sector it examines. As it discovers flaws, it prints 
their locations. 

When the scan is complete, the main menu reappears. 
Enter “1” to see what flaws the scanning process 
disclosed. The program automatically enters any flaws 
it discovers in the new bad track table. 
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If your disk comes with a flaw map, cross-check your 
map against the results of the disk scanning. Because 
most disk flaws are marginal or intermittent, any flaw 
map will almost certainly contain more flaws than the 
scanning process will reveal. 

Depending on the format of your flaw map, select 
either option 4, Add Entries by Head/Cylinder #, or 
option 5, Add Entries by Block Number, and enter the 
flaws, one per line. Enter “q” when you are finished. 
Note that badtrk does not map flaws outside the 
XENIX area, and does not allow you to add such 
entries to the flaw map. 

Exit badtrk by entering “q” at the main menu. 

For more information, see badtrk(M) in the XENIX 

Reference. 

7. Next, you see a prompt from divvy. The divvy program 
divides a partition into file systems. You can create up 
to seven divisions on a single partition, and name them 
anything you like. 

If the hard disk you are installing is 20 megabytes or 
larger, you will be prompted for the number of file 
systems you want to create. Press RETURN to use the 
default value of one file system. Smaller hard disks 
automatically default to creating one file system. 

You are next prompted for block control of your hard 
disk. You see: 

Do you require block by block control over 
the layout of the XENIX partition? (y/n) 

Enter “y” and press RETURN. This allows you to create up 
to seven file systems on a single XENIX partition, and assign 
specific names to whatever file systems you create. You must 
enter “y” if you asked to create more than 1 file system in the 
previous prompt. 


V 
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You see the main divvy menu and a display that shows you 
how your disk is divided: 


Block 

Partition 

Character 

Part. 

Overwrite? 

# 

First Block 

Last Block 

dll50 

rdll50 

yes 

0 

0 

24344 



no 

1 

- 

- 



no 

2 

- 

- 



no 

3 

- 

- 



no 

4 

- 

- 



no 

5 

- 

- 



no 

6 

- 

- 

d!157all 

rdll57all 

no 

7 

0 

25546 


display] 

b[lock] 

character] 

overwrite] 

p[revent] 

s[tart] 

e[nd] 

t[rade] 

r[estore] 


Display the divvy table. 

Change the name of a division’s block interface. 

Change the name of a division’s character device. 

Overwrite a division with a new file system. 

Prevent a division from being overwritten as a new file system . 
Start a division on a different block. 

End a division on a different block. 

Trade the blocks that two divisions refer to. 

Restore default root partition table. 


Please enter your choice or ’q’ to quit: 

Each line in the divvy table corresponds to a file system. For 
example, the default names for file system 0 are dll50 for the 
block device and rdll50for the character device. 

To change the name of a file system, use option “b” to 
change its block name. You could name it, for example, 
usr2. Then use option “c” to change the character name of 
that same file system to, for example rusr2. The character 
name should be the same as the block name, except that it 
should start with the letter “r”. 

Do not change the configuration of file system 7. It is 
reserved for internal use by XENIX. 
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Exit from divvy by entering “q”. The program may prompt 
whether to install the new partition table, return to the main 
menu or exit the program without installing partition table. 
Select option “i” to install the partition table. 

If you have a large file system, you maybe asked if you want a 
scratch device to be created for you. You should answer yes. 

For more information on divvy (C) see the XENIX Reference . 

8. The next step is to create one or more filesystems on the new 
disk using the mkdev command. You should still be in 
system maintenance mode. 

This example creates a mounted filesystem called / usr2 , 
which you set up earlier using divvy. 

mkdev fs /dev/usr2 /usr2 
This command does the following: 

• Creates a directory /usr2 (also known as the mount 
point). 

• Creates the lost+found directory (used by fsck to 
recover files if the file system is corrupted) . 

• Creates files in the /usr/lost+found directory, then 
removes them. This allocates inodes for the 
directory, so that if the file system is corrupted and 
runs out of inodes, fsck(C) is still able to recover 
files. 

• Adds the following line to / etc/ checklist: 

/dcv/usr2 

• Modifies leiclrc so that the new file system is 
automatically mounted, checked and cleaned 
when appropriate. 
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Note 

If you remove a filesystem at some future time, it will be 
important to undo the tasks performed by this procedure. 


Now you can move files, if you want, to the new hard disk. To move 
select files from your original hard disk to your newly installed hard 
disk, use the following command: 

cd olddir 

tar cf - filenames | (cd newdir ; tar xf -) 

where olddir is the directory on the original hard disk, newdir is the 
new directory on your new hard disk, for example /usr2, and 
filenames is a list of the files or directories you wish copied. 

Warning: Never place crucial system directories, such as /, /bin, 
/dev , and /etc, on a second hard disk. They should always be on the 
primary, boot disk. 

5.2 Clockrate Adjustment 

The clocks of some computers operate at a different frequency than 
the default setting. You can check the accuracy of your clock rate 
using date(C) command over a period of days. If the system clock 
gains or loses time excessively, refer to the manual page clockrate(C) 
for information on setting the clock rate. 

The default clock rate for generic 8086 and 80286 machines is 
1.19318. The correct clock rate for an AT&T 6300 or Olivetti M24 is 
1.22878. 
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5.3 IMAGEN printers — ips(C) 

When --using an IMAGEN printer in parallel printer mode (using 
ipbs, see ips(C)) you must specify the quote character as ASCII 2 
and the EOF character as ASCII 4. Control characters must be 
“taken as is”. Refer to the IMAGEN system manuals provided with 
the printer, for information on specifying these characters in the 
printer configuration. 

5.4 Serial I/O Chips 

Some computers or add on serial I/O cards use the 8250a serial I/O 
chip. This chip does not handle interrupts properly. DOS does not 
use interrupts, so the use of this chip with DOS causes no problems. 
XENIX does make use of interrupts, as it is a multi-tasking operating 
system. The problem with the serial I/O chip shows up when using 
uucp(C) orcu(C). Indications that your computer contains an 8250a 
chip are that uucp(C) may lose characters constantly and generate 
unkillable uucico processes and that cu(C) at high baud rates hangs 
and will not exit. 

The problem rarely shows up when using the serial port with a 
terminal. It is associated with high-speed serial input. If you want to 
use uucp(C) or cu(C) and your computer has one of these chips, we 
recommend you replace the 8250a chip with an 8250b serial I/O chip 
or use a multi-function card containing a serial port and configure it 
as COM1 or COM2. Configure the built-in serial port as COM3 or 
COM4, which are not used by XENIX, or avoid using the port with 
high-speed input. 
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5.5 Serial Lines 

There are 4 and 8 port serial port expansion cards available. The 
ports on these cards are accessible only when the jumpered I/O 
address is properly set. The addresses vary for different 
manufacturers of boards, and for the port. The following table lists 
(hexadecimal) addresses for the Hostess, Amet, AST, Digiboard, 
Sperry, and Stargate expansion cards. The AMI, Hostess, 
Digiboard, Arnet, and Stargate cards are available in 4 and 8 port 
versions. The AST and Sperry cards are available in 4 port version 
only. The Sperry' card works with the Sperry PC/IT only. 



Serial Card Addresses 





Primary 

Primary 

Alternate Alternate 

Physical 

Board 

I/O 

Status 

I/O 

Status 

Port 

Type 

Address Address 

Address 

Address 


Hostess 

0x500 

n/a 

0x680 

n/a 


Arnet 

0x100 

0x140 

0x280 

0x2C0 

COM1 

AST* 

0x2 A0 

n/a 

none 

n/a 

AMI lamb** 

OxlCO 

0x220 

none 

n/a 


Stargate 

0x290 

n/a 

none 

n/a 


Digiboardf 

0x110 

0x150 

none 

n/a 


Hostess 

0x580 

n/a 

0x700 

n/a 


Arnet 

0x180 

OxlCO 

0x300 

0x340 

COM2 

AST* 

OxlAO 

n/a 

none 

n/a 

AMI lamb** 

0x2C0 

0x210 

none 

n/a 


Stargate 

0x190 

n/a 

none 

n/a 


Digiboardf 

0x210 

0x250 

none 

n/a 

OTHER1 

Sperry*** 

0x400 

n/a 

none 

n/a 

OTHER2 

Sperry*** 

0x408 

n/a 

none 

n/a 
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* Only enhanced mode is supported. 

Do not use the AST driver. 

** Only continuous mode is supported. 


*** These serial cards only work on the Sperry PC/IT. 
■y | Notes on theDigiboard serial card: 


1. Ports for switches DS2 to DS5 (DS9 for 8 port version) must 
be strapped starting at the boards base address as given in the 
table and incrementing by 8 for each port, example for 
COMlatllO: 



DS1 

110 

. 

DS2 

118 

" ii 

DS3 

120 


DS4 

128 


DS5 

130 


DS6 

138 


DS7 

140 


DS8 

148 


DS1 

150 



2. If COM1 is used then all the ports must be strapped as 
"EVEN" to interrupt request line 4 (see Digiboard 
documentation), if COM2 is used then all the ports must be 
strapped as "ODD" to interrupt request line 3 (same 
notation). 

3. Only rev. 3 and later boards are supported. 


All COM1 boards should be strapped at interrupt vector 4. All 
\ COM2 boards should be strapped at interrupt vector 3. Check your 
serial card hardware manual or call the hardware manufacturer for 
the switch settings that implement these addresses. 

v : Refer to Appendix A “Compatible Hardware” of these Release 
Notes and the serial(M) and manual pages for more information on 
,|||; compatible serial I/O cards and on adding and enabling serial lines. 
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6. Software Notes 

This section explains some software issues of note. 

6.1 Creating a Hi- Density Bootable Floppy 

The Jetc/fd96boot0 file has been included in this release to help you 
create a hi-density bootable floppy. The following commands will 
allow you to use this file to create high density (96 tpi) bootable 
floppies, if you save these instructions into a file, you may use the 
shell script, on the following page, as a boot floppy generator. 
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# 96 tpi boot floppy generator -- /bin/sh script 

# Suggested file location: /etc/mk96boot 
/usr/bin/format /dev/rfd096dsl5 

/bin/dd if=/etc/fd96boot0 of=/dev/rfd96dsl5 count=l conv=sync 

/etc/mkfs /dev/rfd096dsl5 1000 1 15 

/etc/mount /dev/fd096dsl5 /mnt 

/bin/cp /boot /xenix /mnt 

/bin/mkdir /mnt/dev 

# The following devices should be present for all disk operations 
/etc/mknod /mnt/dev/console c 0 0 

/etc/mknod /mnt/dev/null c 4 2 
/etc/mknod /mnt/dev/root b 2 52 
/etc/mknod /mnt/dev/rroot c 2 52 

# The following devices should be present for hard disk operations 

echo "Do you plan to access the hard disk after booting from this floppy?" 

read booter 

if [ booter = "y" ] 

then 

/etc/mknod /mnt/dev/hdOa b 1 47 

/etc/mknod /mnt/dev/hdOroot b 1 40 

/etc/mknod /mnt/dev/rhdOa c 1 47 

/etc/mknod /mnt/dev/rhdOroot c 1 40 

/bin/mkdir /mnt/mnt /mnt/tmp /mnt/bin /mnt/etc 

/bin/cp /etc/haltsys /etc/init /etc/inir /etc/fdisk /mnt/etc 

/bin/cp /etc/mount /etc/umount /mnt/etc 

/bin/cp /bin/sh /bin/sync /bin/fsck /bin/ls /bin/cp /bin/mv /mnt/bin 
fi 

/etc/umount /dev/fd096dsl5 


6.2 uname(S) 

No XENIX utilities currently use the node name in the uname 
structure. XENIX utilities use the entry in /etc/systemid . However, 
some sites may want to set the node name in the uname structure. 
The node name can be up to 9 characters. You can set the node name 
by using the link kit to recompile a new XENIX kernel (refer to 
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Chapter 4 of the XENIX Installation Guide “Installing Device 
Drivers”), or you can use adb(CP) to patch the existing XENIX 
kernel. 

If you use adb, you must be logged in as super-user (root). Enter 
single-user, system maintenance mode (refer to shutdown(C)) . 

These instructions set the node name to ‘newname\ Computer 
responses are boldface. Note that addressses are given relative to the 
utsncune location. You do not need to specify the absolute 
hexadecimal location. 

To set the node name to ‘newname’ : 

* adb -w /xenix 

* utsname+9/s 
_utsname+0x9.: 

* /w ’ne’ 

_utsnanie+9: 0x0= 0x656e 

* <Press RETURN > 

_utsname+ll.: 

* /vv ’wn’ 

_utsname+ll.: 0x0= 0x6e77 

* <Press RET URN > 

__utsname+13.: 

* /w ’am’ 

_utsname+13.: 0x0= 0x6d6I 

* <Press RETURN > 

_utsname+15.: 

* /w V 

_utsname+15.: 0x0= 0x65 

* utsname+9/s 
_utsname+9.: newname 

* $q 

Once you have patched the kernel with adb, shutdown(C) and 
reboot the system. When the system is rebooted, 

uname -a 

should show the ‘newname’ node entry. 
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6.3 Include Files and Utilities 

Machine dependent Development System include files and utilities 
are included on the 2.1.3 Operating System N/z Volumes. If you do 
not install the Link Kit and the Development System set, you will not 
be prompted to extract any files off some of the N/z volumes. 

6.4 cron(C) 

Normally, cron(C) is only started in letclrc . Whenever a new entry, 
that needs to be acknowledged, is added to cron, the super-user 
should check for the process ! etc! cron , kill it, and reinvoke: 

/etc/cron 

Refer to the manual page cron(C) for more information on the 
initialization process. 

6.5 crypt(C) 

The crypt(C) command has been removed from XENIX System V. If 
you want the crypt(C) utility and associated crypt(S) libraries, and 
you live in the United States, contact the support center listed on the 
support information card included with the software. 

6.6 csh(C) - sh(C) Conflicts 

The C-shell, csh(C), has many built-in commands with the same 
name and functionality, but different syntax, than those used by the 
sh(C) shell. The sh(C) commands are those documented in the 
XENIX Reference . An example of two commands which exhibit this 
behavior are echo and nice. Refer to the manual page csh(C) for 
information on built-in C-shell commands. 

An /etc/cshrc file is included with this release. You can customize the 
C-shell environment for all csh(C) users by using this file (similar to 
I etc! profile for sh(C) users). 
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6.7 fdisk(C) 

The fdisk(C) utility does not allocate the last track on the hard disk 
unless the “Use Entire Disk for XENIX” option is used. The 
“Create XENIX Partition” option always leaves the last track 
unassigned. 

For example, if a disk has 2442 tracks, fdisk reports these as tracks 
0-2441. It will assign (using the “Create XENIX Partition” option) 
tracks 1-2440. Track 0 is reserved. Track 2441 is only assigned with 
the “Use Entire Disk for XENIX” option. 

6.8 format(C) 

The format(C) utility does not format floppies for use under DOS. 
Also, XENIX requires error free floppies. 

6.9 mvdir 

You must be super-user (root) to use this command. 

6.10 pg(C) 

This release now includes the pg(C) utility. 

6.11 runbig(C) 

The utility runbig(C) is included in version 2.1.3 of the Development 
System. 
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1.2 Using Raw Devices 

When using dd(C) or tar(C) with a raw device, specify the block size 
as a multiple of IK, which is equivalent to 2 “b.” This is 
recommended because dd (C) and tar(C) use 512 byte blocks. The 
XENIX filesystem uses 1024 byte blocks. For example, for dd (C) 
using a 9K (system) block size use: 

dd if=file of=/dev/rfd0 bs=18b 

Specify an even blocking factor with tar(C): 

tar cvfb /dev/rfdO 18 file 

or use the default tar settings (see tar(C)). 

1.3 uucp(C) Notes 

This section answers questions you may have about uucp(C) and 
cu(C). The installation of the uucp programs and utilities is 
optional. Refer to the chapter “Building a Micnet Network” in the 
XENIX Operations Guide and the chapter on “Building a 
Communications System” in the XENIX User’s Guide. Also refer to 
custom(C) to install (or remove) communications files. 


1.3.1 Modem Usage under XENIX 

Refer to the XENIX Operations Guide chapter “Using Peripheral 
Devices” for information on modem settings, modem control, 
aliasing alphabetic characters and dialing with your computer. 


1.3.2 Autodialing 

In addition to the program on the dial(M) manual page, the C 
language program, /usr/lib/uucp/dial.c, for the distributed 
/usr/lib/uucp/dial is included in this release. You can copy and 
modify dial.c or you can use these as examples to write programs to 
use other kinds of modems. The makefile distributed in 
/usr/lib/uucp should be modified to reflect your own dialer program. 
You must have the XENIX Development System in order to compile 
C programs. 
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If you create a dial program for another modem, send us the source. 
User generated dial programs will be considered for inclusion in 
future releases. 

The uucp dialup timeout has been increased with this release. This 
increase is sufficient to allow uucp to dial long distance numbers on 
pulse dial telephone lines. 


1.3.3 L-devices and L.sys 

We recommend running uucp(C) direct connections at 2400 or 4800 
baud so that the system’s performance is not impaired. These baud 
rates are specified in the files /usr/lib/uucp/L-devices and 
lusr/lib/uucp/L.sys . 

Do not use tabs as field separators in the L.sys file. 

1.3.4 Communications with 3.0 XENIX Systems 

If you have trouble connecting to a XENIX System 3.0 with uucp(C), 
try making that system ‘‘active” and the SCO XENIX System V the 
“slave”. 


1.3.5 Restriction in the USERFILE 

USERFILES used in this release must start with the line: 
uucp, / 

followed by at least one other line. 

Because the uucp login can be accessed by many users (some of 
whom may be undesirable) it is recommended that uucp not be used 
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as a login. To ensure proper security, an additional user may be 
created with uucico as its login shell. Many systems use the uu generic 
convention as the user login, where generic represents the system’s 
machine name. 

6.14 vsh(C) 

The use of special characters (*, [, ], and ?) is explained in the 
chapter “Basic Concepts” in the Introduction to XENIX. The visual 
shell, vsh(C), docs not currently support the use of these special 
characters when specifying file names. 

The super-user (root) must initialize the visual shell help file before 
other users can have access to it. To do so, follow these steps: 

1. Login as super-user (root). 

2. Invoke the visual shell by entering “vsh” on the command 
line. 

3. When the vsh menu comes up, enter “h” (for help). 

4. The help file appears, with another menu. Enter “r” (for 
resume). 

5. The main vsh menu appears again. You can now quit from 
the v- shell. Enter “q” (for quit), then “y” (to confirm the 
quit). 

The vsh help file is now initialized so that all users have access to 
online help. 
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6.15 console(M) 


The following escape sequences have functions which are not 
documented on the manual page console(M). These features are 
experimental extensions to the ANSI specification and are subject to 
change or removal from other XENIX releases. They are present and 
functional in the XENIX System V 2.1.3 release: 


ESC[ = CA 


ESC[ = F;TB 


ESC [ = Ss;SeC 


where C is 0-15. Sets border color on 
color adaptors. Color codes are same as 
for ESC [ 2 ; Cl ; C2 m . 

Sets bell frequency and duration. F is the 
value loaded into the timer-counter, and 
T is the bell duration in l/10ths of a 
second (initial settings are 1500 and 
2/10ths of a second) . 

Sets cursor to start at scan line Ss , and 
end at scan line Se. Default underline 
cursor is 6,7 for color adaptor and 11,12 
for monochrome. 


Another experimental function is the iocll call for getting the screen 
color from inside a program: 

attr = ioctl(l, GIO_ATTR, 0) 

The attribute is returned in ioctlQ/s return code. The foreground 
color is in the least significant nibble. 


7. Documentation Notes 

This section discusses changes and errors in the documentation. 

7.1 Improved Documentation 

Chapter 4, “Installing Device Drivers” of the XENIX Installation 
Guide has been revised and expanded for this release. 
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7o2 cron(C) 

The last paragraph of the Description section of the cron(C) manual 
page is incorrect. It reads: 

cron examines the crontabs directory periodically to see if it has 
changed; if it has, cron reads it. Tlius it takes only a short while 
for entries to become effective. 

It should read: 

cron will not notice modifications made in the crontab file unless 
the crontab command is used to submit the changed files. 

7.3 Replacement Manual Page 

The sh(C) manual page has been revised for this release. Please 
replace the sh(C) manual page, included with these Release Notes 
with the manual page found in the User's Reference . The 
replacement pages are dated “June 20, 1986”. 


8. Restoring Lost Files 

The custom(C) utility is used to list, install, or remove individual 
files, sets within the XENIX System packages, or entire packages of 
the XENIX System. Refer to custom(C) in the XENIX Reference for 
information on using custom. 
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9. Packages In This Set 


These are the packages in the Operating System: 


Operating System Packages 

ALL 

Entire operating system set 

INST 

XENIX installation utilities 

PERM 

XENIX contents and permissions lists 

RTS 

XENIX run time system 

BASE 

Basic extended utility set 

BACKUP 

System backup and recovery tools 

SYSADM 

System administration tools 

FILE 

File manipulation tools 

LINK 

The link kit 

LPR 

Multiple line printer spooler 

MAIL 

Electronic mail and local area networking 

CSH 

The C- shell 

DOS 

DOS utilities 

VSII 

The visual shell 

EX 

The ex and vi editors 

UUCP 

uucp and cu communications utilities 

‘GAMES 

Fun and games 


Note 

* Games are supplied, as is, for your pleasure and 
enjoyment. They are NOT supported. On line 
documentation is supplied for some of the games, in the 
directory lusrl games/ doc. 
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A. Compatible Hardware 

This appendix describes hardware that can be used with XENIX 
System V. 

The hardware listed in this section has been used with XENIX. 
However, because compatible machine or add-on peripherals 
manufacturers may change configuration or functionality of firmware 
at any time, no guarantee of functionality is implied. Please write us 
with accurate hardware information for possible inclusion on our 
lists. 

Some of the hardware listed requires “vendor supplied drivers.” Ask 
your hardware vendor for the appropriate device driver for SCO 
XENIX V. Be forewarned that device drivers intended for versions 
2.0.3 or earlier may not function with this 2.1.3 release. You must 
link device drivers, supplied by the hardware vendors, into the 
XENIX kernel in order to use some of these devices. For information 
on linking device drivers, see the section “Link Kit” in these Release 
Notes and Chapter 4 of the XENIX Installation Guide “Installing 
Device Drivers.” 
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A.l XENIX— 86 System V 


A. 1.1 Machines 


These machines can run XENIX-86 System V: 

AT&T 6300 (Olivetti M24 in Europe) 

Compuserve/Canada Arthur in Canada 
Compaq Deskpro* and Plus* 

Eagle Turbo 
Ericsson PC 
IBM PC XT 

rrrxp 

ITT XTRA 
Leading Edge 
Mitsubishi 
NCR PC-6** 

Tandy 1200 
Sperry 

Victor VPC 30 and VPC 15 
Wavemate Bullet-286 XT 
WYSE PC 

* Internal cartridge tape not supported. 

** For the NCR machine, configure the switches on the mo- 
therboard for a color monitor, regardless of the type of 
monitor used. 
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Note 

ITT DOS releases previous to 3.10 cannot share the disk 
with XENIX or MS-DOS. For these releases, XENIX, or a 
combination of XENIX and MS-DOS must occupy the 
whole disk on the ITT machines. 

Also note that the ITT XF (286 cpu) and the Wavemate 
Bullet-286 XT (286 cpu) run in 8086 mode. 


Some computers arrive with the hard disk only partially formatted. If 
you have such a machine, use the DOS hard disk format command or 
Diagnostics diskette to format the entire disk before installing the 
XENIX Operating System. 

Some computers require specific switch settings to run XENIX. If 
your computer does not run XENIX with the settings as shipped, 
contact your computer hardware representative for the proper 
settings. 

Some machines may require a clock rate adjustment. Refer to 
section 5.2 of these Release Notes. 


A. 1.2 Math Chips 


You can use these math co-processor chips under XENIX with the 
following Central Processing Units (CPUs): 

8087 For 8088 CPUs. 

8087-2 For 8086 CPUs. 

8087-3 For fast 8086 CPUs. 
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A. 1.3 Memory Cards 

With memory cards, check the switch settings on both the card and 
mother board. Refer to the hardware manuals for your computer 
and for the memory card to find the correct switch settings. XENIX- 
86 supports up to 640K of main memory. 

The following memory cards have been used successfully with 
XENIX-86: 

AST 6 pack* 

Quadrant quadboard 
Sigma Maximizer 
Microsoft RAM card 
Tecmar Captain or First-Mate 
AT&T for the 6300 

AT&T 6300 note: It is recommended that only AT&T memory cards 
be used with the 6300. Other cards may considerably slow the 
machine. 


Note 

In general, most memory cards work with XENIX-86. If 
you experience “panic: parity” errors it is often because of 
low quality memory chips or cards. 


The serial ports on many multi-function cards will function as 
expected if COM! and COM2 are fully compatible with the IBM 
specifications for these serial ports. See section 5.4 “Serial Lines” 
and section A. 1.5 “Serial I/O Boards” in these Release Notes. 


A. 1.4 Accelerator Boards 

Accelerator boards are special cards that plug in to an 8088 machine 
(not an 8086). They replace the 8088 CPU with a 286 CPU and 
perhaps replace some memory as well. XENIX System V runs on 
accelerator boards set in 8086 unmapped mode. 
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The following accelerator board is supported in the standard 
distribution: 

Seattle Telecom and Data (STD) PC286 
A. 1.5 Serial I/O Boards 

Note that you should not use cards that use the 8250a serial I/O chip. 
See the Hardware Notes section in these Release Notes on “Serial 
I/O Chips” for more information on the 8250achip. 

These serial I/O boards are supported in the standard distribution: 

IBM standard COM1 and COM2 

Control Systems Hostess 4 and 8 port versions 

Arnet Controls 4 and 8 port (8250b version) 

(clock option not supported) 

AST FourPORT/XN 
AMI lamb 4 and 8 port 
Digiboard 4 and 8 port 
Stargate Technologies OC4400 (4 port) and 
OC8000 (8 port) versions 


A. 1.6 Tape Units 


The following tape devices are supported using a device driver 
supplied by the hardware vendor: 

Emerald Systems series 2002 - streaming cartridge 

Computone ATvantage-SX Tape backup - streaming cartridge 
Overland Data TC50X - nine track 

(reel to reel) 
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A. 1.7 Video Cards and Monitors 

The following video cards and monitors have been used successfully 
with XENIX-86. (They are to be used in character mode only, 
graphics are not currently supported .) 


Video Cards and Monitors 

Card 

Monitor 

IBM Mono Card 

standard monochrome 

A ST CG A 

Paradise Modular Graphics Card 
Ever ex Edge 

IBMCGA 

standard RGB (red green blue) 
or composite color 

IBM EGA 

standard monochrome 
standard RGB color 

IBM EGA 


Cards which come as the default card in supported computers 
(monochrome or color monitor) work fine with XENIX. 

Although many standard emulating cards work with XENIX, these 
are the ones that we know about. 


A. 1.8 Add On Hard Disks 

Many hard disks can be used by XENIX-86 as long as the disk 
controller supports the drive. Compatible hard disk controllers are 
discussed in the next section. 
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The following tables list the controllers most commonly used with 
8086/8088 machines, and the type of hard disks they can support: 

XEBEC Controller 


(standard IBM PC XT compatible) 


Type 

Cyls 

rids 

Size 

Example 

0 

306 

2 

5MB 


1 

375 

8 

24 MB 


2 

306 

6 

15 MB 


3 

306 

4 


standard 


DTC Controller 

(standard on AT+T 6300 - fully supported) 


Type 

Cyls 

lids 

Size 

Example 

0 

306 

2 

5 MB 


1 

375 

8 

24 MB 


2 

306 

6 

15 MB 


3 

306 

4 

10 MB 


4 

306 

2 

5 MB 

Syquest SQ306 standard 

5 

644 

5 

30 MB 

CDCWren 

6 



20 MB 

Seagate ST-225 

7 



20 MB 

Miniscribc 3425 



Drive types 8 - 

15 reserved 


The following hard disks have been tested successfully with XENIX- 
86: 


Disk Controller 


CMI15 

PLUSHardCard 
Miniscribe 20 
Seagate 20 
CDC30 
Rhodime 30 
Mountain Hard File 
Mountain 20, 30 


XEBEC 

built-in controller 

DTC 

DTC 

DTC 

i 2 

built-in controller 
DTC 
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The following disks are reported to work with XENIX-86, but are 
untested: 

Peachtree 10, 20, 30 
Maynard Apollo 30 
Franklin Telecom 10, 20, 33 
Rhodime 10 
Tandon 10 

Alpha Omega 10, 20, 30 

To determine whether you can use a hard disk with XENIX, the disk 
must first interface electrically with the disk controller (usually 
“ST506”). The disk controller ROM must have an entry' for the disk 
{type) determined by the number of heads, and the number of 
cylinders on the disk. The number of cylinders on your disk must be 
greater than or equal to the number of cylinders listed for that type . If 
these conditions are met, you can use the hard disk, but XENIX can 
only access up to the number of cylinders in the list. 

For example, a “Brand X 40” hard disk has 8 heads and 700 
cylinders. It is a type 1 disk on a XEBEC or DTC controller. You can 
use the Brand X disk, but XENIX can access only 375 cylinders (24 
megabytes) of the disk. The only way to access the full disk is to 
replace the ROM on the disk controller with one that recognizes your 
disk configuration. 


A. 1.9 Compatible Hard Disk Controllers 


Many hard disks will work with XENIX. Whether or not a disk works 
depends upon the controller board. Here are two tests the controller 
must meet: 

1. The disk controller board is XEBEC compatible; and, 

2. There is no special vendor software needed to make the disk 
work under DOS. 

If a controller meets these tests, it might work, but if it fails these 
tests, it will not work. 
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The following table lists the hard disk controllers known to work 
with XENIX-86: 


Manufacturer 

Model# 

Comments 

XEBEC 

1210A 

PC XT std. 
Miniscribe lOmb 
as well as CMI 15 

DTC 

5150 

6300 std. 
Miniscribe 10, 

20, Seagate 20, 
CDC 30, 
Mountain 30 

WD 

1002/WX-2 

a special version 
of WX-2 is 
supplied with 

some CDC 30 
disks. 

Adaptec 

2002 


I 2 interface 


Rhodime 30 

ADES 

CDC 


Comes with the 
CDC 30 addon 
hard disk. 
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A. 2 XENIX-286 System V 

This section discusses some of the hardware known to run with 
XENIX-286. 


A. 2.1 Machines 


These machines can run XENIX-286 System V:f 

Compaq Portable* and DeskPro* 286 
Contcl/CADO AT/4 
Corona ATP 
Epson Equity HI 

IBM PC AT (20 or 30 meg version) 

ITT XTRA XL 
Kaypro 286i 
Mitsubishi-286 
NCR PC-8 ** 

NEC APC IV*** 

Sperry PC/IT 
Tandy 3000 
Tomcat 3200- AT 
WYSEpc 286 WY-2200 
Victor V286 
Zenith Z200 series 

t The AT&T 6300+ runs SCO -286 System V but requires 
a version specific to the 6300+ . 

* Internal cartridge tape not supported. 

** For the NCR machine, configure the CMOS database for 
color monitor, regardless of the type of monitor used. 

*** Works in 6 mHz mode only 

Although the Texas Instruments Business Pro will run SCO XENIX, 
TI XENIX is directly available from TI (and supports more 
peripherals on TI machines). 
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Note 

For machines with bus or processor speeds greater than 6 
mHz, check with your peripheral vendor to verify that 
their hardware will run under your configuration. 

ITT DOS releases previous to 3.10 cannot share the disk 
with XENIX or MS-DOS. For these releases, XENIX, or a 
combination of XENIX and MS-DOS must occupy the 
whole disk on the ITT machines. 


A. 2.2 Math Chips 

You can use the following math co-processor chip with XENIX-286: 
80287 For 80286 CPUs 


A. 2.3 Memory Cards 

With memory cards, check the switch settings on both the card and 
mother board. Refer to the hardware manuals for your computer 
and for the memory card to find the correct switch settings. XENIX- 
286 supports up to 16 megabytes of main memory, however, 
hardware modifications might be necessary to add this much 
memory. 

The following memory cards have been used successfully with 
XENIX-286:f 

AMI SMART PACK 2 

AST 

Quadram 

Tecmar 

Talltree Systems 
Silicon Valley Systems 
STB Rio Grande 

t For the 6300+ , AT&T memory cards are required. 
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Note 

In general, most memory cards work with XENIX-286. If 
you experience “panic: parity” errors it is often because of 
low quality memory chips or cards. 


A. 2.4 Serial I/O boards 


Note that you should not use cards which have the 8250a serial I/O 
chip. See the section in these Release Notes on “Serial I/O” for more 
information on the 8250a chip. 

The following serial I/O boards are supported in the standard 
distribution: 

AMI lamb 4 and 8 port 
Digiboard 4 and 8 port 
Arnet Controls 4 and 8 port (8250b version) 

(clock option not supported) 

AST FourPORT/XN 

Control Systems Hostess 4 and 8 port versions 
IBM standard COM1 and COM2 cards 
Sperry* 4 port card 

Stargate Technologies OC4400 (4 port) and 
OC8000 (8 port) versions 

* This serial I/O board only works with the Sperry PC/IT. 

The following serial I/O boards are supported using a device driver 
supplied by the hardware vendont 

Computone ATvantage-X smart serial expansion 
ITT MTS 186 smart serial expansion 

t not for the 6300+ 
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A. 2. 5 Tape Units 

The following tape devices are supported using a device driver 
supplied by the hardware vendor. 

Computone ATvantage- SX tape backup 
Emerald Systems series 2002 
Overland DataTC50X 

ITT Tecmar/Wangtek 


streaming cartridge 
streaming cartridge 
nine track 
(reel to reel) 
streaming cartridge 


A.2.6 Video Cards and Monitors 

The following video cards and monitors have been used successfully 
with XENIX-286. (They are to be used in character mode only, 
graphics are not currently supported .)t 


Video Cards and Monitors 

Card 

Monitor 

IBM Mono Card 

standard monochrome 

A ST CG A 

Everex Edge 

IBMCGA 

Paradise Modular Graph ics Card 

standard RGB (red green blue) 
or composite color 

IBMEGA 

standard monochrome 

standard RGB color 

IBMEGA 

VMI CGA/Graphics Adapter * 

VMI high resolution 


t not aplicable for the 6300+ which has an integral video controller. 
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* This card provides for two planes of screen - one is a standard CG A 
and uses the standard SCO driver, and the other is a graphics plane 
that is provided via a distinct special file in I dev. 

Cards which come as the default card in supported computers 
(monochrome or color monitors) work fine with XENIX. 

Although many standard emulating cards work with XENIX, these 
are the ones that we know about. 


A. 2.7 Graphics Cards 


This graphics card is supported using a device driver supplied by the 
hardware vendor: 

VMI CGA/Graphics Adapter 


A. 2. 8 Networking Cards 

This networking card is supported using a device driver supplied by 
the hardware vendor: 

Excelan ethernet card - TCP/IP ARP A standard 

Sytek PC Network - SCO XENIX Networks package 

A. 2.9 Add On Hard Disks 


Many hard disks can be used by XENIX-286 as long as the 
motherboard ROM supports the drive. ROM entries for the IBM 
PC AT are listed here. Refer to your computer hardware manual for 
the disk types supported by other computers. 
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PC AT Disk Types Entries on Motherboard ROM 


Type 

Cyls. 

lids. 

Size 

1 

306 

4 

10 MB 

2 

615 

4 

20 MB 

3 

615 

6 

30 MB 

4 

940 

8 

60 MB 

5 

940 

6 

45 MB 

6 

615 

4 

20 MB no precompensation 

7 

462 

8 

30 MB 

8 

733 

5 

30 MB 

9 

900 

15 

110 MB 

10 

820 

3 

20 MB 

11 

855 

5 

35 MB 

12 

855 

7 

50 MB 

13 

306 

8 

20 MB 

14 

733 

7 

40 MB 

15 

0 

0 

Reserved, do not use. 


Note that other compatible XENIX-286 machines may have different 
ROM tables. Check your computer hardware reference manual for 
the appropriate ROM table entries for your computer. 

The following hard disks have been tested with XENIX-286:t 


CDC20 

Emerald 50, 70, 140 
Maxtor 140 
CDC30 


with PC AT only 
with PC AT only 
with PC AT as Type 9 
with Sperry PC/IT only 


t 6300-f- AT&T supported configurations should work. 


To determine whether you can use a hard disk with XENIX, the disk 
must first interface electrically with the disk controller (usually 
“ST506”). The motherboard ROM must have an entry for the disk 
{type) determined by the number of heads, and the number of 
cylinders on the disk. The number of cylinders on your disk must be 
greater than or equal to the number of cylinders listed for that type . If 
these conditions are met, you can use the hard disk, but XENIX can 
only access up to the number of cylinders in the list. 
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For example, a “Brand X 140” hard disk has 15 heads and 1000 
cylinders. It is a type 9 disk on the AT. You can use the Brand X disk, 
but XENIX can access only 900 cylinders (110 megabytes) of the disk. 
The only way to access the full disk is to replace the ROM on the 
motherboard (or other hardware modification) with one that 
recognizes your disk configuration . 


A. 2. 10 Compatible Hard Disk Controllers 

Many hard disks will work with XENIX. Whether or not a disk works 
depends upon the controller board. Here are two tests the controller 
must meet: 

1. The disk controller board is XEBEC compatible; and, 

2. There is no special vendor software needed to make the disk 
work under DOS. 

If a controller meets these tests, it might work, but if it fails these 
tests, it will not work. 
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The following table lists the hard disk controllers known to work 
with XENIX-286: 


Manufacturer 

Model# 

Comments 

WD 

1010 

standard AT 

winchester/floppy 
controller card 

WD 

1010,2010 

winchester only 
controller card 



(standard on 

PC/IT, for 

example) 

DTC 

WD1010 clone 

winchester only 
controller card 


A. 3 Modems and Autodialing 

Any standard RS-232 modem will work with XENIX-86 and 
XENIX-286 for personal computers using uucp(C) and cu(C). The 
default autodialer is for the Ilayes Smartmodem 1200. An autodial 
program is also supplied for the Racal Vadic 3451 . Other autodialing 
modems can be supported by writing a dialer program. See the 
manual page dial(M) in the XENIX Reference and section 6.12.2 of 
these Release Notes for information on writing other dialer programs. 


B. Upgrading to XENIX System V 

The following procedure shows you how to upgrade XENIX-86 3.0 
and XENIX-286 3.0 to XENIX System V. This procedure does not 
apply if you are installing XENIX System V for the first time. 
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Part of the process is to completely reinstall XENIX. With a complete 
reinstallation you are assured of having all the latest software, your 
disk is less fragmented when you are finished, and, if you want, you 
can easily change the size of the XENIX partition or the size of the 
XENIX swap zone at this time. 

This procedure does not affect any other operating systems (or 
partitions), such as MS-DOS, that currently share the disk with 
XENIX 3.0, unless you choose to change partition sizes. Refer to 
Chapter 3 of the XENIX Installation Guide “Using DOS and XENIX 
on the Same Disk” if you want to change the size of your XENIX 
partition. 

Before proceeding, be sure to read all of these Release Notes , 
including new manual pages. Note changes in the software since the 
last time you installed XENIX. 

Follow these steps to upgrade your XENIX system: 

1. Shut the system down to Single User (System Maintenance) 
Mode. 

2. Make a full backup of your system. 

3. Save particular files from your current system. 

4. Install XENIX System V. 

5. Relink the kernel, if necessary. 

6. Reinstall any applications software packages. 

7. Merge the saved files with the reinstalled system. 

Note that these are the basic steps and the exact procedure may vary 
from site to site. Examples are given wherever possible, but you 
should know how to use commands such as tar(C) (or cpio(C)). 

Remember that an initial pound sign (#) in the examples is the root 
prompt and is a reminder that you should execute the listed 
command only when logged in as root. You do not enter the pound 
sign as part of the command. 
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If you have local system modifications to the kernel, such as 
additional device drivers, you must relink these into the new link kit 
after you reinstall XENIX. Check with the supplier of the other 
software for further details. 

When upgrading from SCO XENIX-86 System 3.0 to SCO XENIX-86 
System V, you must save applications data files in ASCII or symbolic 
form, not as binaries. This is because the word order was changed 
from System 3.0 to System V in XENIX-86. 

Binaries from SCO, IBM, or Microsoft XENIX-286 System 3.0 are 
compatible with SCO XENIX-286 System V binaries. However, 
saving data files in A SCII or symbolic form is still a good idea. 

When you restore files after reinstalling XENIX, use the applications 
to convert your data back to binary form. The procedure for saving 
data files is discussed in a following section “Data Files and ar(CP) 
Libraries.” Restoring data files is discussed in a following section 
“Merging Saved Files.” 

B.l Shut Down the System 

You should be the only person logged in to your computer when you 
perform the upgrade. Make sure any other users know what you are 
going to do, and when you are going to do it. They may wish to make 
their own backups before you. bring down the system. 

Also, advise users to remove unnecessary files. This makes the 
whole process faster and requires fewer floppies, if they are your only 
backup media. 

Refer to shutdown(C) in the XENIX Reference for information on 
bringing the system down to Single User (or System Maintenance) 
Mode. 

B.2 Backup the System 

Before you do anything else, make a full backup of the system. Use 
the tar(C) or cpio(C) commands. Refer to tar(C) and cpio(C) in the 
XENIX Reference . You cannot use any other filesystem backup 
utilities. 
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You should make a backup immediately before you upgrade so that 
you have the latest possible version of your system. This is especially 
important in the case of user files, which can change frequently. 

Once again, remove any old, unnecessary files. This makes the 
whole process faster. 

B.3 Save Special Files 

You can use any backup media, including floppy and tape drives, to 
save most of your files. Note that if you use a special driver with your 
backup device, you cannot use that device immediately after 
installing XENIX System V, since the new kernel is not yet linked 
with the required device driver. Therefore, for precautionary 
reasons, we recommend that you backup your files on floppies 
before you install XENIX System V. 

Before you can use any special devices, you must link the new XENIX 
kernel. If you have source for the device drivers, save the source 
code on the default backup device, the floppy drive, then recompile 
the driver on the new system. Also, if you need special, customized 
libraries, or if any libraries are furnished with your device drivers, 
save these libraries with the device driver source. 

This is important, since you can only read information from the 
default device, once you reinstall XENIX, until you link the kernel. 


B.3.1 Choosing Which Files To Save 


You should save any files that are customized or are in some way 
particular to your system. These files include: 

• Applications data files and ar(CP) libraries. 

• Any standard system files that are modified for your site. 

• Any locally created shell scripts or programs. 

® All user directories, subdirectories and files. 

At this time, make sure you have the original distributions of any 
applications packages you use. You must reinstall those software 
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packages after you upgrade the XENIX system. 

Save any files you use with your applications, such as databases and 
control files, in ASCII or symbolic form. For example, if you use 
Lyrix, you should save all the files in the /usr/lib/wp directory. Note 
that Lyrix data files are already in ASCII form, and you can save them 
directly onto your backup media. 

You should check the following standard XENIX system files and 
directories for local changes made to the XENIX 3.0 standard 
distribution. Save those files which have local modifications. 
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File or Directory: 


/.profile 

/etc/profile 

/etc/cshrc 

t/etc/default/* 

t/etc/group 

i/etc/passwd 

t/ etc/rc 

i/etc/systemid 

f/etc/ttys 

/etc/ttytype 

/etc/termcap 

/lib 

/usr/bin/* 

/usr/dict/words 

/usr/include/* 

/usr/lib/mail/* 

/usr/lib/crontab 

/usr/lib/font/* 

/usr/lib/lint/* 

/usr/lib/tabset/* 

/usr/lib/term/* 

/usr/lib/tmac/* 

/usr/lib/uucp/* 

t/usr/news 

/usr/spool/* 

t/usr/[janed , johnd] 


XENIX 3.0 Files 

Examine for: 


root sh startup script. 

System wide sh startup script. 

System wide csh startup script. 

For local changes. 

Group database. 

User database. 

For any local additions. 

The name of your system. 

Terminal line configuration data. 

Terminal line to terminal type mapping data. 
For any local entries. 

For locally developed language processors. 
For local additions. 

For local additions to words. 

For local additions. 

For local mail routing information . 
cron daemon database. 

For locally developed font libraries. 

For locally developed lint libraries. 

For locally developed tab setting files. 

For locally developed nroff driving tables. 
For locally developed nroff/troff macros. 

For local uucp configuration files and dialers. 
For local news. 

For current mail, uqcp, at, and other files. 
User home directories. 
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It is very important that the files marked with a dagger (f) be 
examined carefully before reinstalling on XENIX System V. Check 
the files for local additions or changes, but do not replace the System 
V versions with your XENIX 3.0 versions. There are changes to 
content, and sometimes format, of these files with System V. Using 
the 3.0 versions of these files can cause problems. This is the case for 
most of this list. Those directories marked with a double dagger (t) 
can safely be copied from your 3.0 system. The last item in the above 
list refers to all individual user directories on the root file system. 
User directories may be in another location or /usr may be 
mountable on your system. 


B.3.2 Save the Actual Files 

When using floppies, make sure they are error free and formatted. 
XENIX requires high quality media. 

The tar command is a convenient way to save files. You can also use 
the cpio command. For example, to save the standard system files 
located in /etc, enter: 

# cd / 

# tar cv ./etc/profile ./etc/group ./etc/rc ./etc/ ttys ./etc/ttytype ./etc/termcap 

Remember to use the “relative pathname” format with tar. For 
example, specify Jetc /profile, not /etc! profile, where the dot (.) 
indicates the pathname is relative to your current directory. 

Make sure you label any floppies or tapes you use with their exact 
contents, the command used to create the backup, the date and 
time, and if they are part of a multi-volume set. If you use more than 
one volume (floppy or tape), use the k option with tar. 

These commands save some user directories as well as other 
directories in /usr: 

# cd / 

# tar cv ./usr/johnd ./usr/janed ,/usr/spool ,/usr/news 
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These commands save all the Lyrix custom system files in 
/usr/lib/wp : 

# cd / 

# tar cv ./usr/lib/wp 

For more information on tar, see the XENIX Reference. 

B.3.3 Save Data Files and ar(CP) Libraries 

If you are using XENIX-86, you must follow these guidelines for 
saving data files and ar libraries. These steps are not necessary under 
XENIX-286, however they are a good precaution. 

Data Files 

Applications, such as Multiplan, Informix and Level II COBOL use 
data files, which you must save in A SCII or symbolic form. 

With Multiplan, use the TRANSFER OPTION command to save data 
files in symbolic ( SYLK) format. Then transfer the SYLK files to your 
backup media. 

See the “Command Director)'” in the Multiplan User’s Guide for 
more information on TRANSFER OPTION. See also Appendix 4 
“The SYLK (Symbolic Link) File Format” in the Multiplan User’s 
Guide. 

You can save Informix data files using the Informix UNLOAD 
command. Also, with UNLOAD you can transfer a file directly to 
your backup media. For information on UNLOAD, see your Informix 
manual under “dbstatus.” 

All Level II COBOL programs you create are completely portable, so 
you can save them using tar or cpio without any special handling. 
However, C-ISAM® files created under XENIX-86 3.0 cannot be 
transferred to XENIX-86 System V. You must recreate any such files 
on the new system. 

Extracting and merging your data files is described in section B.7, 
under “Merging Data Files” and “ar(CP) Libraries”, in these Release 
Notes. 
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ar(CP) Libraries 

To save ar archive files, you: 

• Extract the files that make up the archive from the archive 
file. 

• Save the extracted files on your backup media. 

For example: 

# cd /usr/lib 

# ar xv libisam.a 

When the extract command is finished , you save the resulting files on 
your backup media: 

# tar cv 'ar t libisam.a' 

Recreating archives on the new system is discussed section B.7, 
under “Merging Data Files” and “ar(CP) Libraries”, in these Release 
Notes . 

B.4 Install XENIX System V 

After you have backed up the system and saved all special files that 
you need for your system, install XENIX System V. Follow the 
instructions in the XENIX Installation Guide in the binder marked 
“XENIX Operating System Run Time Environment” to install the 
XENIX Operating System, furnished with System V. 

If you have special device drivers, you need to link them into the 
XENIX kernel when you are finished installing. In this case, make 
sure you install the link kit software when you reinstall XENIX. 

Also, you must recompile any device drivers under SCO XENIX 
System V. If you are going to recompile any device drivers, be sure to 
install the Development System. If you do not have source code for 
the device drivers you use, you should obtain new binaries which run 
under SCO XENIX System V from the manufacturer or vendor of the 
device. 
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When you are finished installing, make sure you are in Single User, or 
System Maintenance Mode. Then return to the next section to merge 
the special files you saved with your new operating system. 

B.5 Relink the Kernel 

If you have special device drivers, you must: 

• Recompile the software under XENIX System V, or obtain a 
replacement. 

• Link the driver in to the XENIX kernel with the link kit. 

Any device drivers compiled under SCO XENIX 3.0 must be 
recompiled under System V, You may have to obtain an SCO XENIX 
System V version of any drivers from the driver or device 
manufacturer if you do not have source code. 

Make sure you installed the link kit software. If you have not done 
so, sec custom(C) for information on extracting packages from 
XENIX System V distributions. 

B.6 Reinstall Applications 

All SCO XENIX 3.0 applications run on SCO XENIX System V. 
Therefore, you should use the original distribution floppies to 
reinstall any applications. 

See the appropriate release notes and installation manuals for 
information on installing any applications programs. Install any such 
programs as if this is the first time. 

Do not copy or save the applications from the old system, unless the 
original distributions are lost or damaged, and you cannot replace 
them. It is safer to reinstall applications software packages. 

B.7 Merge Saved Files 

Once XENIX and any applications are reinstalled, you can merge in 
new files. This section describes the procedure for merging standard 
system files, data files, and ar libraries. 
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Note 

Remember that all commands given in this section are 
only examples. The exact procedure depends upon how 
and in what order you saved your files and directories. 


For standard system files, except for /usr/spool and 
/usrl\janed f johnd\ files, prepare a temporary directory and extract 
the files from a backup volume into this directory: 

# mkdir /usr/convert 

# cd /usr/convert 

# tar x 

Move the extracted files to their correct locations , for example if you 
have extracted files which belong in /etc : 

# mv ./etc/* /etc 

Repeat the tar extraction for each volume you made. 

The spooling directory and the users’ home directories are very 
simple to extract directly into the correct directories. For example, 
with the media containing / usr/\johnd , janed] and /usr/spool 
mounted in the default device, enter: 

# cd /usr 

# tar xv 

Special Lyrix files can be extracted in place from your backup media. 
For example, with the backup volume containing /usr/lib/wp 
mounted in the default device: 

# cd /usr/lib/wp 

# tar xv 
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Other files, however, must be merged into the distributed versions by 
hand, for example, with the following files already extracted into the 
convert directory: 

# cd /usr/convert/etc; cp passwd group ttytype /etc 

# cd /usr/convert/usr/lib 

# cp crontab /usr/spool/cron/crontabs/root 

Be careful when merging files, especially complex data files like 
/ etc/rc , / etc/termcap , or I etc! ttys. Use the diff(C) program to note 
the differences between newly installed files, and those you save from 
your previous system. Add the differences, if they are necessary, to 
the new System V files. Do not directly overwrite the System V 
versions with your 3.0 version files. 

After all the files have been examined and local site information is 
merged into the System V files, remember to clean up: 

# cd / ; rm -fr /usr/convert 
Merge Data Flies 

For Multiplan data files that are saved in symbolic form, extract them 
into the appropriate directories from the backup media. Then use 
the Multiplan command TRANSFER OPTIONS to translate the file 
from symbolic form. 

With Informix, extract the data files into the appropriate directories. 
Use the LOAD command, described in the “dbstatus” section of the 
Informix manual. 

ar(CP) Libraries 

To merge archive and library files, create a scratch directory, or work 
in /tmp. Mount the backup volume containing the appropriate 
libraries. Remember, you saved them individually. 

Extract the files, for example: 

# cd /tmp 

# tar xv 

Rearchive the extracted files, for instance with our libisam.a 
example: 

# ar ruv libisam.a *.o 
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When the archive is created, run the ranlib program: 

# ranlib libisam.a 

Finally, move the new archive back to the appropriate directory and 
remove any unneeded files: 

# mv libisam.a /usr/lib 

# rm *.o 

Your upgrade is now complete. 


XG86/286-6-20-86-3.0/2.1.3 - 64- The Santa Cruz Operation 



Operating System Release Notes 


A. Common Installation/Configuration Questions and 
Answers 

This section is our support department’s combined effort to present 
answers to common installation/configuration questions. 

• PROBLEM: When I try to read one of the distribution 
floppies I get the error message: Error on dev floppy (2/4) 
block=xxx cmd=0003 status=0002 

tar: tape read error 


REMEDY: First try it on another machine. If it is a boot 
floppy or a filesystem floppy, try booting it on a similar 
machine (your dealer may be able to assist you). If it is not a 
boot floppy or a filesystem , floppy try reading it using 
DISKCOPY under DOS, or use the following command on 
a XENIX system: 

dd if=/dev/install of=/dev/null < RETURN > 

If any of these yields a message similar to the one on your 
own system, you need a new floppy, obtained at no charge 
by calling the toll-free support number. 

• PROBLEM: When booting from the boot floppy, 
"EEEEEE's print on the console and the system hangs. 

REMEDY: Try booting a DOS floppy, or other bootable 
diskette. If the machine can boot a diskette, then your boot 
floppy is corrupted. You may obtain one at no charge by 
calling the toll-free support number. 


• PROBLEM: I tried to install once, but didn’t make it all the 
way through. I am trying again, but when the filesystem 
floppy is in the drive, I get the error message: 

’’Out of Inodes on dev floppy (2/4)" 

REMEDY: Temporary files used during installation still 
exist from the aborted installation. They can be removed in 
one of two ways. If you do not have access to another 
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XENIX system, use the procedure outlined below to remove 
the temporary files. If you do have access to another XENIX 
system, begin at step #8. 

1. Boot the boot floppy and then the filesystem floppy 
following the installation instructions up through 
the point where you see the message: 

"During installation you may choose to overwrite 
all or part of the present contents of your disk. 
Do you wish to continue? (y/n)" 

When you see this message, press the DEL key to 
abort the installation and get the "<Installation>" 
prompt. 

2. List the temporary files by typing: 

echo /dev/b* /dev/c* <RETURN> 

3. Write down the names of the files, all EXCEPT 
/dcv/console. 

4. Move the file /dev/null over the first file in your list: 

mv /dev/null /dev/filel <RETURN> 

5. Repeat this step until only one file remains from 
your list. 

6. Move the last file over /dev/null by typing: 

mv I dev Hast file /dev/null <RETURN> 

7. Shutdown the system: 

/etc/hallsys <RETURN> 

Now you are ready to re-install. If you still can’t 
install, call the toll-free support number. 

If you do have a running XENIX system, you can 
use the procedure outlined below to clean your 
filesystem floppy. 
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8. Boot your XENIX system, then insert the filesystem 
floppy in the drive and mount it: 

/etc/mount /dev/install /nmt <RETURN> 

9. Check for the temporary files, and write down their 
names, all EXCEIT/dev/console: 

cd /mnt/dev <RETURN> 

Is b* c* <RETURN> 

10. Next remove the temporary filenames with the "rm" 
command: 

rm filel, file2. . .filen <RETURN> 

11. Unmount the diskette: 

cd / <RETURN> 

/etc/umount /dev/install <RETURN> 

Now you are ready to re-install with your filesystem 
floppy. If you still can’t install, call the toll-free 
support number. 


• PROBLEM: When booting up, the console screen blanks 
out or the display is garbled. 

REMEDY: You may have an incompatible monitor card. 
Check the Release Notes for a list of supported video cards 
and monitors. If yours is not listed but compatible with one 
on the list, it should work. If not, check your card’s 
hardware manual to see if there are ways to configure the 
switch settings so the card is in an IBM- 
compatible/emulation mode and that it is addressing the 
kind of monitor attached. If changing the switch settings 
fails, then your monitor card is incompatible, and should be 
replaced with a compatible card. 
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• PROBLEM: I see the error message: 

Panic: memory failure — parity error 

REMEDY: Some pai t of your hardware is sending a “non- 
maskable memory error interrupt” (a signal sent by the 
harware that halts the operating system) . Run your system’s 
hardware diagnostics tests, both startup and advanced. 
Physically re- seat your memory cards, and check for bent 
pins, etc. If these measures fail to correct the problem, or 
you don’t feel comfortable in checking your hardware 
yourself, seek assistance from professional hardware 
experts. One frequent cause is memory chips that are slower 
than factory- recommended chips. 


• PROBLEM: During installation when the hard disk 
initialization program is invoked , installation is aborted and 
I get the error message: 

Cannot Get Disk Parameters 

REMEDY: Hard disks are compatible with SCO XENIX as 
long as there is an entry in the ROM BIOS describing your 
drive. Your hard disk is not described among the controller 
entries in the ROM BIOS. (See the XENIX Operating 
System Release Notes for more information.) 

You can correct the problem in one of several ways: 

1. You can use a different disk that is supported by the 
ROM table on your system. 

2. If you have the ability to customize a ROM, it is 
possible to change or customize a ROM entry so it 
supports non-standard hard disk parameters. 
Western Digital will make a custom ROM for their 
customers. Golden Bow Systems of San Diego, 
CA provide an extended ROM BIOS for non- 
standard hard disks for IBM ATs. If neither of 
these suggestions help, check with your hardware 
manufacturer. 
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In a future release, we will be able to support non-standard 
disks, not supported by the ROM BIOS, as XENIX will be 
able to auto-configure itself to any size hard disk. 


• PROBLEM: I am trying to add a terminal to a serial port, 
but do not get a login. 

REMEDY: Follow these procedures to locate the cause of 
the problem. 

1. If you are using a 4 or 8-port serial expansion 
board, check to see if your board is recognized at 
bootup by checking the bootup message. If not, 
the switches on your card are not set properly. 
Check your board’s hardware documentation for 
the proper switch settings and SCO XENIX Release 
Notes for the correct addresses. Be sure it doesn’t 
conflict with the interrupts for the standard COM 
ports . COM1 should be configured as interrupt 4 
and COM2 as interrupt 3. When the card is 
correctly configured, run "/etc/mkdev serial” which 
creates device files for your extra serial ports. 

2. Make sure you are in multi-user mode, your 
terminal is plugged in and turned on and set for 
9600 baud, 8 data bits, 1 stop bit, no parity. (If your 
terminal doesn’t send these, then see the section 
titled "Changing the gettydefs File” in Chapter 7 of 
the Operations Guide for ways to configure your 
terminal.) The terminal should be connected with 
a cable so that Transmit Data on the serial port is 
connected to Read Data on the terminal, and 
Transmit Data on the terminal is connected to Read 
Data on the serial port (see your terminal manual 
for more information.) 
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3. If the port is enabled, hit the RETURN key a few 
times to see if a ’login:’ prompt appears. If so, you 
are ready to login. If not, disable the port by typing: 

disable /dev/ttyname <RETURN> 

where ttyname is the device special filename of the 
port in question. (For more information on the 
naming convention for serial ports, see serial(M) in 
the User’s Reference.) Make sure you’re using the 
non-modem control device. Also, be sure to wait 
several seconds between each disable or enable 
command. 

4. Check the /etc/ttys file so the entry for this serial 
port looks like this: 

Omttyname 

If it does not look like the example above, then edit 
/etc/ttys with a text editor to correct it. Also, if 
/etc/ttys contains entries for ttyll, ttyl2, ttyl3, and 
ttyl4, replace them with ttyla, tty2a, ttylA, tty2A, 
respectively. 

5. From the console, as root, see if you can redirect 
output to your terminal by typing: 

date > /dev/ttyname <RETURN> 

If you do not see the date printed on your terminal 
and you are not sure of the correct ttyname, try 
other ttynames on that serial port. If you still do not 
see the date printed, a hardware problem is 
possible, so verify the following: 

- Your cable is configured correctly (see #2 
above). Also, try using only pins 2, 3 and 
7. 

- Re-check your terminal setup 
configuration (see #2 above) 0 
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Re-check your switches on your serial 
port. If you are using a multi-port card, 
try other lines on that card. 

- Try attaching the terminal to a standard 
serial port, COM1 or COM2, to see if the 
terminal and cabling is correct. 

If you have SCO XENIX 5, Release 2.1 
and also have the SNA product, you 
cannot use COM2, as SNA uses COM2, 
interrupt vector 3. 

6. Once you get the dale printed on your terminal, 
then enable the port and look for the ’login:’ 
prompt. 

enable /dev/ttyname <RETURN> 

If you do not see the ’login’ prompt, then verify that 
getty is actually running on that port and that the 
software is configured properly by typing: 

ps -tl ttyname <RETURN> 

The output should look similar to the following 
where "login" or "getty" is listed in the "CMD" 
column. 

PS UID PED PPID C PRI NI ADDRSZ WCHANTTY 
TIME CMD 1 S 214 9210 1 0 30 20 344 22 6994 2a 0:06 
getty 


7. If you have typed the disable and enable 
commands many times, it is possible that a new 
getty cannot be spawned on that port. If so, then 
shutdown the system, re-boot, go into Multi-user 
mode, and try again. 

• PROBLEM: I’m trying to print on a parallel printer but am 
getting no response or very slow printing. 

REMEDY : Verify the following items, as it is important that 
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your parallel ports be configured properly to work under 
XENIX: 

1. The printer must be IBM compatible and should 
use a standard Centronics interface cable in order 
for it to work at all. 

2. The typical personal computers only support up to 
2 parallel ports. Deconfigure additional ports. 

3. The parallel port on the monochrome card should 
be configured for interrupt vector 7, and is 
recognized aslpl. 

4. The main parallel port should be configured for 
interrupt vector 7 and is recognized as IpO. So you 
must use either the main or the monochrome’s 
port--not both--to avoid a hardware conflict 
which would cause slow printing. 

5. The alternate/second parallel port should be 
configured for interrupt vector 5, and recognized as 
lp2. Make sure no other hardware is using these 
interrupts. (See your hardware manual for 
information on configuring your parallel ports.) 

6. If your parallel ports are configured properly, as 
described above and you still get slow printing, your 
parallel port may not be capable of generating 
interrupts. XENIX uses interrupts while DOS 
doesn’t so this port may work under DOS but not 
XENIX. You should replace it with an a real 
compatible parallel port that does support 
interrupts. 

• PROBLEM: I can’t get a printout on my serial printer. 

REMEDY: Make sure your serial printer is configured 
properly under XENIX: 
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1. Refer to Notes #1-2 above in the section 
describing "How to get a login on a terminal". In 
addition, be sure your printer is both capable of 
supporting XON/XOFF protocols and also 
configured for XON/XOFF protocols rather than 
DTR or other protocols. Verify that it is turned on 
and the cable is properly attached to the computer 
and printer. 

2. If the port is enabled, disable it by typing: 

disable /dev/ttyname <RETURN> 

where ttyname is the device special filename of the 
port in question. (For more information on the 
naming convention for serial ports, see SERIAL 
(M) in the User’s Reference Guide.) Make sure 
you’re using the non-modem control device. Also, 
be sure to wait several seconds between each 
disable or enable command. 

3. From the console, as root, see if you can redirect 
output to your printer by typing: 

date > /dev/ttyname <RETURN> 

If you do not see the date printed on your printer 
and you are not sure of the correct ttyname, try 
other ttynames on that serial port. If you still do not 
see the date printed, hardware is suspect so verify 
the following: 

- Your cable is configured correctly (see #1 
above). Also, try using only pins 2, 3 and 
7. 

- Re-check your printer configuration by 
verifying its switches in your printer 
hardware manual. (See item #1 above.) 

- Re- check your switches on your serial 
port. If you are using a multi-port card, 
try other lines on that card and be sure it 


XGS6/286-6-20-86-3.0/2.1.3 - 73- The Santa Cruz Operation 



XENIX for personal computers 


does not conflict with the standard COM 
ports. 

Try attaching the printer to a standard 
serial port, COM1 or COM2, to see if the 
printer and cabling is correct. 

If you have SCO XENIX 5, Release 2.1 
and also have the SNA product, you 
cannot use COM2 as SNA uses COM2, 
interrupt vector 3. 

4. When you get the date printed on your printer, you 
should run / elc/lpinit to configure the spooler to 
support this printer. (See Chapter 7 of the 
Operations Guide for more information on 
/etc/lpinit.) Then be sure to enter the correct stty 
options in the spooler’s interface script 
(/usr/spool/lp/interface/printemame) to control 
the baud rate, XON/XOFF protocol, and other 
options as necessary. The baud rate and 
XON/XOFF protocol should match the baud rate 
set on your printer. 

• PROBLEM: How can I get my termtype set automatically 
when I login? 

REMEDY: XENIX can be' easily configured to 

automatically set the termtype upon login by following these 
procedures: 

1. Login on the terminal in question and determine 
which ttyname you’re using by typing: 

tty < RETURN > 

2. Login as root and edit the file, /etc/ttytype, with a 
text editor. First, change occurrences of ttyll, 
tty 12, ttyl3 and ttyl4 to ttyla, tty2a, ttylA and 
tty2A, respectively. Next, change the termtype 
field for the line associated with the terminal in 
question to the termtype you desire to use. Follow 


XG86/286-6-20-86-3.0/2.1.3 - 74 - The Santa Cruz Operation 



Operating System Release Notes 


the model for the console. If you want your 
term type to be set to appropriate entry is: 

wy50 ttyla 

3. Then the user’s start up file must be edited with the 
appropriate "tset" command line to automatically 
set the term type. In each C- shell user’s .login file, 
add the following lines: 

tset -s -Q > /tmp/tset$$ 
source /tmp/tset$$ 

/bin/nn /tmp/tset$$ 

Be sure the remove the default setenv command 
line involving TERM and TERMCAP from the 
.login file. 

In each Bourne Shell user’s .profile, add the 
following line: 

eval ‘tset -s‘ 

Be sure to remove the existing ’tset’ command line 
from the .profile file. 

4. Have each user logout, then login again to test the 
new termtype change. After login, have them 
verify the new termtype by typing: 

env <RETURN> 
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Name 


sh - Invokes the shell command interpreter. 


Syntax 

sh [ — ceiknrstuvx ] [ args ] 


Description 

The shell is the standard command programming language that exe- 
cutes commands read from a terminal or a file. See Invocation 
below for the meaning of arguments to the shell. 


Commands 

A simple— command is a sequence of nonblank words separated by 
blanks (a blank is a tab or a space). The first word specifies the 
name of the command to be executed. Except as specified below, 
the remaining words are passed as arguments to the invoked com- 
mand. The command name is passed as argument 0 (see exec(S)). 
The value of a simple-command is its exit status if it terminates 
normally, or (octal) 1000+.ste/z/.s if it terminates abnormally (i.e., if 
the failure produces a core file). See signal(S) for a list of status 
values. 

A pipeline is a sequence of one or more commands separated by a 
vertical bar ( |). (The caret ("), also has the same effect.) The 
standard output of each command but the last is connected by a 
pipe(S ) to the standard input of the next command. Each com- 
mand is run as a separate process; the shell waits for the last com- 
mand to terminate. 

A list is a sequence of one or more pipelines separated by ;, &, 
&&> or 1 1, and optionally terminated by ; or & . Of these four sym- 
bols, ; and & have equal precedence, which is lower than that of 
&& and 1 1. The symbols && and 1 1 also have equal precedence. A 
semicolon (;) causes sequential execution of the preceding pipeline; 
an ampersand (&) causes asynchronous execution of the preceding 
pipeline (i.e., the shell does not wait for that pipeline to finish). 
The symbol && ( 1 1 ) causes the list following it to be executed only 
if the preceding pipeline returns a zero (nonzero) exit status. An 
arbitrary number of newlines may appear in a list, instead of semi- 
colons, to delimit commands. 
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A command is either a simple-command or one of the following 
commands. Unless otherwise stated, the value returned by a com- 
mand is that of the last simple-command executed in the com- 
mand: 

for name [ in word . . . ] 
do 

list 

done 

Each time a for command is executed, name is set to the next word 
taken from the in word list. If in word is omitted, then the for 
command executes the do list once for each positional parameter 
that is set (see Parameter Substitution below). Execution ends 
when there are no more words in the list. 

case word in 

[ pattern [ \ pattern ] . . . ) list 

;; ] 

esac 

A case command executes the list associated with the first 
pattern that matches word. The form of the patterns is the same as 
that used for filename generation (see Filename Generation below). 

if list then 
list 

[ elif list then 
list ] 

[ else list ] 
fi 

The list following if is executed and, if it returns a zero exit status, 
the list following the first then is executed. Otherwise, the list fol- 
lowing elif is executed and, if its value is zero, the list following the 
next then is executed. Failing that, the else list is executed. If no 
else list or then list is executed, then the if command returns a zero 
exit status. 

while list 
do 

list 

done 

A while command repeatedly executes the while list and, if the exit 
status of the last command in the list is zero, executes the do list; 
otherwise the loop terminates. If no commands in the do list are 
executed, then the while command returns a zero exit status; until 
may be used in place of while to negate the loop termination test. 

(list) 

Executes list in a subshell. 
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{list-,} 

list is simply executed. 


name () {list;} 

Define a function which is referenced by name. The body of 
functions is the list of commands between { and }. Execution 
of functions is described later (see Execution.) 


The following words are recognized only as the first word of a com- 
mand and when not quoted: 

if then else elif fi case esac for while until do done { } 


Comments 

A word beginning with # causes that word and all the following 
characters up to a newline to be ignored. 


Command Substitution 


The standard output from a command enclosed in a pair of grave 
accents ( vx ) may be used as part or all of a word; trailing newlines 
are removed. 


Parameter Substitution 

The character $ is used to introduce substitutable parameters. Posi- 
tional parameters may be assigned values by set. Variables may be 
set by writing: 

name=value [ name=value ] .. . 

Pattern-matching is not performed on value . 

${ parameter } 

A parameter is a sequence of letters, digits, or underscores (a 
name) y a digit, or any of the characters *, @, $, and !. 

The value, if any, of the parameter is substituted. The braces 
are required only when parameter is followed by a letter, digit, 
or underscore that is not to be interpreted as part of its name. 
A name must begin with a letter or underscore. If parameter is 
a digit then it is a positional parameter. If parameter is * or @, 
then all the positional parameters, starting with $1, are substi- 
tuted (separated by spaces). Parameter $0 is set from argument 
zero when the shell is invoked. 
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${parameter:— word} 

If parameter is set and is not a null argument, substitute its 
value; otherwise substitute word. 

${parameter:=word} 

If parameter is not set or is null, then set it to word ; the value 
of the parameter is then substituted. Positional parameters may 
not be assigned to in this way. 

${parameter:?word } 

If parameter is set and is not a null argument, substitute its 
value; otherwise, print word and exit from the shell. If word is 
omitted, the message “parameter null or not set” is printed. 

%{para meter :+ word } 

If parameter is set and is not a null argument, substitute word ; 
otherwise substitute nothing. In the above, word is not 
evaluated unless it is to be used as the substituted string, so that 
in the following example, pwd is executed only if d is not set or 
is null: 

echo ${d:- v pwd v } 

If the colon (:) is omitted from the above expressions, then the 
shell only checks whether parameter is set. 

The following parameters are automatically set by the shell: 

# The number of positional parameters in decimal 

— Flags supplied to the shell on invocation or by the set command 

? The decimal value returned by the last synchronously executed 
command 

$ The process number of this shell 

! The process number of the last background command invoked 
The following parameters are used by the shell: 

CDPATH 

Defines search path for the cd command. See the section Spe- 
cial Commands , “cd”. 

HOME 

The default argument (home directory) for the cd command 

PATH 

The search path for commands (see Execution below) 
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MAIL 

If this variable is set to the name of a mail file, then the shell 
informs the user of the arrival of mail in the specified file 

MAILCHECK 

This parameter specifies how often (in seconds) the shell will 
check for the arrival of mail in the files specified by the 
MAILPATH or MAIL parameters. The default value is 600 
seconds (10 minutes). If set to 0, the shell will check before 
each prompt. 

MAILPATH 

A colon (:) separated list of file names. If this parameter is set, 
the shell informs the user of the arrival of mail in any of the 
specified files. Each file name can be followed by % and a mes- 
sage that will be printed when the modification time changes. 
The default message is you have mail. 

PS1 

Primary prompt string, by default “$ ” 

PS2 

Secondary prompt string, by default “> ” 

IFS 

Internal field separators, normally space, tab, and newline 
SHACCT 

If this parameter is set to the name of a file writable by the user, 
the shell will write an accounting record in the file for each shell 
procedure executed. Accounting routines such as acctcOm(C) 
and accton(C ) can be used to anaylze the data collected. 

SHELL 

When the shell is invoked, it scans the environment (see 
Environment below) for this name. If it is found and there is an 
V in the file name part of its value, the shell becomes a res- 
tricted shell. 

The shell gives default values to PATH, PS1, PS2, and IFS, while 
HOME and MAIL are not set at all by the shell (although HOME is 
set by login (M)). 


Blank Interpretation 

After parameter and command substitution, the results of substitu- 
tion are scanned for internal field separator characters (those found 
in IFS) and split into distinct arguments where such characters are 
found. Explicit null arguments ("" or ") are retained. Implicit 
null arguments (those resulting from parameters that have no 
values) are removed. 
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Filename Generation 

Following substitution, each command word is scanned for the 
characters *, ?, and [ . If one of these characters appears, the 
word is regarded as a pattern. The word is replaced with alphabeti- 
cally sorted filenames that match the pattern. If no filename is 
found that matches the pattern, the word is left unchanged. The 
character . at the start of a filename or immediately following a /, 
as well as the character / itself, must be matched explicitly. These 
characters and their matching patterns are: 

* Matches any string, including the null string. 

? Matches any single character. 

[...] 

Matches any one of the enclosed characters. A pair of charac- 
ters separated by — matches any character lexically between the 
pair, inclusive. If the first character following the opening 
bracket ([) is an exclamation mark (!), then any character not 
enclosed is matched. 


Quoting 

The following characters have a special meaning to the shell and 
cause termination of a word unless quoted: 

;&()|*<> newline space tab 

A character may be quoted (i.e., made to stand for itself) by 
preceding it with a \. The pair \newline is ignored. All characters 
enclosed between a pair of single quotation marks ("), except a 
single quotation mark, are quoted. Inside double quotation marks 
(""), parameter and command substitution occurs and \ quotes the 
characters \, \ ”, and $. "$*" is equivalent to "$1 $2 . . .' , whereas 
“$@” is equivalent to "$1” ”$2" . . . 


Prompting 

When used interactively, the shell prompts with the value of PS1 
before reading a command. If at any time a newline is typed and 
further input is needed to complete a command, the secondary 
prompt (i.e., the value of PS2) is issued. 
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Spelling Checker 

When using cd(C) the shell checks spelling. For example, if you 
change to a different directory using cd and misspell the directory 
name, the shell repsonds with an alternative spelling of an existing 
directory. Enter “y” and press RETURN 9or just press RETURN) 
to change to the offered directory. If the offered spelling is 
incorrect, enter “n”, then retype the command line. In this exam- 
ple the sh(C) response is boldfaced: 

$ cd /usr/spol/uucp 
cd /usr/spool/uucp?y 
ok 

Input/ Output 

Before a command is executed, its input and output may be 
redirected using a special notation interpreted by the shell. The fol- 
lowing may appear anywhere in a simple-command or may precede 
or follow a command. They are not passed on to the invoked com- 
mand; substitution occurs before word or digit is used: 

<word Use file word as standard input (file descriptor 0). 

>word Use file word as standard output (file descriptor 1). 

If the file does not exist, it is created; otherwise, it 
is truncated to zero length. 

»word Use file word as standard output. If the file exists, 

output is appended to it (by first seeking the 
end-of-file); otherwise, the file is created. 

«[- ]word The shell input is read up to a line that is the same 
as wordy or to an end-of-file. The resulting docu- 
ment becomes the standard input. If any character 
* of word is quoted, no interpretation is placed upon 
the characters of the document; otherwise, parame- 
ter and command substitution occurs, (unescaped) 
\newline is ignored, and \ must be used to quote the 
characters \, $, \ and the first character of word. 
If - is appended to « , all leading tabs are 
stripped from word and from the document. 

<& idigit The standard input is duplicated from file descriptor 

digit (see dup( S)). Similarly for the standard output 
using > . 

<&— The standard input is closed. Similarly for the stan- 

dard output using >. 
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If one of the above is preceded by a digit, the file descriptor 
created is that specified by the digit (instead of the default 0 or 1). . 
For example: 

... 2>&1 

creates file descriptor 2 that is a duplicate of file descriptor 1. 

If a command is followed by &, the default standard input for the 
command is the empty file /dev/null. Otherwise, the environment 
for the execution of a command contains the file descriptors of the 
invoking shell as modified by input/output specifications. 


Environment 

The environment (see environ (M)) is a list of name-value pairs that 
is passed to an executed program in the same way as a normal argu- 
ment list. The shell interacts with the environment in several ways. 
On invocation, the shell scans the environment and creates a 
parameter for each name found, giving it the corresponding value. 
Executed commands inherit the same environment. If the user 
modifies the values of these parameters or creates new ones, none 
of these affect the environment unless the export command is used 
to bind the shell’s parameter to the environment. The environment 
seen by any executed command is composed of any unmodified 
name-value pairs originally inherited by the shell, minus any pairs 
removed by unset, plus any modifications or additions, all of which 
must be noted in export commands. 

The environment for any simple— command may be augmented by 
prefixing it with one or more assignments to parameters. Thus: 

TERM=450 cmd args 

and 

(export TERM; TERM=450; cmd args) 

are equivalent (as far as the above execution of cmd is concerned). 

If the — k flag is set, all keyword arguments are placed in the 
environment, even if they occur after the command name. 


Signals 

The INTERRUPT and QUIT signals for an invoked command are 
ignored if the command is followed by &; otherwise signals have 
the values inherited by the shell from its parent, with the exception 
of signal 11. See the trap command below. 
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Execution 

Each time a command is executed, the above substitutions are car- 
ried out. Except for the Special Commands listed below, a new 
process is created and an attempt is made to execute the command 
via e.vec(S). 

The shell parameter PATH defines the search path for the directory 
containing the command. Alternative directory names are 
separated by a colon (:). The default path is :/bin:/usr/bin (speci- 
fying the current directory, /bin, and /usr/bin, in that order). Note 
that the current directory is specified by a null pathname, which 
can appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If the command name 
contains a /, then the search path is not used. Otherwise, each 
directory in the path is searched for an executable file. If the file 
has execute permission but is not an a. out file, it is assumed to be a 
file containing shell commands. A subshell (i.e., a separate pro- 
cess) is spawned to read it. A parenthesized command is also exe- 
cuted in a subshell. 

Shell procedures are often used by users running the csh. How- 
ever, if the first character of the procedure is a # (comment charac- 
ter), csh assumes the procedure is a csh script, and invokes 
/binJcsh to execute it. Always start sh procedures with some other 
character if csh users are to run the procedure at any time. This 
invokes the standard shell Ibin/sh . 

The location in the search path where a command was found is 
remembered by the shell (to help avoid unnecessary execs later). If 
the command was found in a relative directory, its location must be 
re-determined whenever the current directory changes. The shell 
forgets all remembered locations whenever the PATH variable is 
changed or the hash — r command is executed (see below). 


Special Commands 

Input/output redirection is permitted for these commands: 

: No effect; the command does nothing. A zero exit code is 
returned. 

. file 

Reads and executes commands from file and returns. The 
search path specified by PATH is used to find the directory con- 
taining file. 

break [ n ] 

Exits from the enclosing for or while loop, if any. If n is 
specified, it breaks n levels. 
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continue [ n ] 

Resumes the next iteration of the enclosing for or while loop. If 
n is specified, it resumes at the n- th enclosing loop. 

cd [ arg ] 

Changes the current directory to arg. The shell parameter 
HOME is the default arg. The shell parameter CDPATH defines 
the search path for the directory containing arg. Alternative 
directory names are separated by a colon (:). The default path 
is <null> (specifying the current directory). Note that the 
current directory is specified by a null path name, which can 
appear immediately after the equal sign or between the colon 
delimiters anywhere else in the path list. If arg begins with a /, 
the search path is not used. Otherwise, each directory in the 
path is searched for arg. 

If the shell is reading its commands from a terminal, and the 
specified directory does not exist (or some component cannot be 
searched), spelling correction is applied to each component of 
directory , in a search for the “correct” name. The shell then asks 
whether or not to try and change directory to the corrected direc- 
tory name; an answer of n means “no”, and anything else is taken 
as “yes”. 

echo [ arg ] 

Writes arguments separated by blanks and terminated by a new- 
line on the standard output. Arguments may be enclosed in 
quotes. Quotes are required so that the shell correctly interprets 
these special escape sequences: 

\b Backspace 

\c Prints line without newline. 

\f Form feed 
\n Newline 
\r Carriage return 
\t Tab 

\v Vertical tab 
\\ Backslash 

\n The 8-bit character whose ASCII code is the 1, 2 or 3-digit octal 
number n must start with a zero 

eval [ arg . . . ] 

The arguments are read as input to the shell and the resulting 
command(s) executed. 

exec [ arg . . . ] 

The command specified by the arguments is executed in place of 
this shell without creating a new process. Input/output argu- 
ments may appear and, if no other arguments are given, cause 
the shell input/output to be modified. 
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exit [ n ] 

Causes a shell to exit with the exit status specified by n. If n is 
omitted, the exit status is that of the last command executed. 
An end-of-file will also cause the shell to exit. 

export [ name . . . ] 

The given names are marked for automatic export to the 
environment of subsequently executed commands. If no argu- 
ments are given, a list of all names that are exported in this shell 
is printed. 

hash [ — r ] [ name . ... ] 

For each name , the location in the search path of the command 
specified by name is determined and remembered by the shell. 
The — r option causes the shell to forget all remembered loca- 
tions. If no arguments are given, information about remem- 
bered commands is presented. Hits is the number of times a 
command has been invoked by the shell process. Cost is a 
measure of the work required to locate a command in the 
search path. There are certain situations which require that the 
stored location of a command be recalculated. Commands for 
which this will be done are indicated by an asterisk (*) adjacent 
to the hits information. Cost will be incremented when the 
recalculation is done. 

newgrp [ arg . . . ] 

Equivalent to exec newgrp arg . . . 

pwd 

Print the current working directory. See p\vd(C) for usage and 
description. 

read [ name . . . ] 

One line is read from the standard input and the first word is 
assigned to the first name , the second word to the second name , 
etc., with leftover words assigned to the last name. The return 
code is 0 unless an end-of-file is encountered. 

readonly [ name . . . ] 

The given names are marked readonly and the values of the 
these names may not be changed by subsequent assignment. If 
no arguments are given, a list of all readonly names is printed. 

return [ n ] 

Causes a function to exit with the return value specified by n. If 
n is omitted, the return status is that of the last command exe- 
cuted. 

set [ — eknuvx [ arg . . . ] ] 

-e 

If the shell is noninteractivc, exits immediately if a command 
exits with a nonzero exit status. 

— f Disables file name generation. 
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-h 

Locates and remembers fuction commands as functions are 
defined (function commands are normally located when the 
function is executed). 

— k 

Places all keyword arguments in the environment for a com- 
mand, not just those that precede the command name. 

— n 

Reads commands but does not execute them. 

— u 

Treats unset variables as an error when substituting. 

—v 

Prints shell input lines as they are read. 

—x 

Prints commands and their arguments as they are executed. 
Although this flag is passed to subshells, it does not enable 
tracing in those subshells. 

Does not change any of the flags; useful in setting $1 to -. 

Using + rather than — causes these flags to be turned off. 
These flags can also be used upon invocation of the shell. The 
current set of flags may be found in $— . The remaining argu- 
ments are positional parameters and are assigned, in order, to 
$1, $2, . . . If no arguments are given, the values of all names 
are printed. 

shift 

The positional parameters from $2 . . . are renamed $1 . . . 
test 

Evaluates conditional expressions. See test(C) for usage and 
description. 

times 

Prints the accumulated user and system times for processes run 
from the shell. 

trap [ arg ][«].. . 

arg is a command to be read and executed when the shell 
receives signal(s) n. (Note that arg is scanned once when the 
trap is set and once when the trap is taken.) Trap commands 
are executed in order of signal number. The highest signal 
number allowed is 16. Any attempt to set a trap on a signal that 
was ignored on entry to the current shell is ineffective. An 
attempt to trap on signal 11 (memory fault) produces an error. 
If arg is absent, all trap(s) n are reset to their original values. If 
arg is the null string, this signal is ignored by the shell and by 
the commands it invokes. If n is 0, the command arg is exe- 
cuted on exit from the shell. The trap command with no argu- 
ments prints a list of commands associated with each signal 
number. 
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type [ name . . . ] 

For each name , indicate how it would be interpreted if used as a 
command name. 

ulimit [ [ — f ] n ] 

imposes a size limit of n blocks on files. 

— f imposes a size limit of n blocks on files written by child 
processes (files of any size may be read). Any user may 
decrease the file size limit, but only the super-user (root) can 
increase the limit. With no argument, the current limit is 
printed. 

If no option is given and a number is specified, — f is assumed, 
unset [ name . . . ] 

For each name, remove the corresponding variable or function. 
The variables PATH, PS1, PS2, MAILCHECK and IFS cannot be 
unset. 

umask [ ooo ] 

The user file-creation mask is set to the octal number ooo 
where o is an octal digit (see umask{ C)). If ooo is omitted, the 
current value of the mask is printed. 

wait [ n ] 

Waits for the specified process to terminate, and reports the ter- 
mination status. If n is not given, all currently active child 
processes are waited for. The return code from this command 
is always 0. 

Invocation 

If the shell is invoked through e.vec(S) and the first character of 
argument 0 is — , commands are initially read from /etc/profile and 
then trom $HOME/. profile, if such files exist. Thereafter, com- 
mands are read as described below, which is also the case when the 
shell is invoked as /bin/sh. The flags below are interpreted by the 
shell on invocation only; note that unless the — c or — s flag is 
specified, the first argument is assumed to be the name of a file 
containing commands, and the remaining arguments are passed as 
positional parameters to that command file: 

— c string If the — c flag is present, commands are read from 
string. 

-s If the — s flag is present or if no arguments remain, com- 

mands are read from the standard input. Any remaining 
arguments specify the positional parameters. Shell out- 
put is written to file descriptor 2. 

“t If the — t flag is present, a single command is read and 

executed, and the shell exits. This flag is intended for 
use by C programs only and is not useful interactively. 
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— i If the — i flag is present or if the shell input and output 

are attached to a terminal, this shell is interactive. In 
this case, TERMINATE is ignored (so that kill 0 does 
not kill an interactive shell) and INTERRUPT is caught 
and ignored (so that wait is interruptible). In all cases, 
QUIT is ignored by the shell. 

— r If the — r flag is present, the shell is a restricted shell 

(see rsh (C)). 

The remaining flags and arguments are described under the set 
command above. 

Exit Status 

Errors detected by the shell, such as syntax errors, cause the shell 
to return a nonzero exit status. If the shell is being used nonin- 
teractively, execution of the shell file is abandoned. Otherwise, the 
shell returns the exit status of the last command executed. See the 
exit command above. 

Files 

/etc/profile 
$HOME/. profile 
/tmp/sh* 

/dev/null 


See Also 

cd(CX env(C), login(M), newgrp(C), rsh(C), test(C), umask(C), 
dup(S), exec(S), fork(S), pipe(S), signal(S), umask(S), wait(S), 
a.out(F), profile(M), environ(M) 


Notes 

The command readonly (without arguments) produces the same 
output as the command export. 

If « is used to provide standard input to an asynchronous process 
invoked by &, the shell gets mixed up about naming the input docu- 
ment; a garbage file /tmp/sh* is created and the shell complains 
about not being able to find that file by another name. 

If a command is executed, and a command with the same name is 
installed in a directory in the search path before the directory 
where the original command was found, the shell will continue to 
exec the original command. Use the hash command to correct this 
situation. 
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If you move the current directory or one above it, pwd may not 
give the correct response. Use the cd command with a full path 
name to correct this situation. 
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Release Notes Addendum 


XENIX® 2. 1.3 A 

This Release Notes Addendum provides additional information 
concerning setting up Winchester partitions. 


SETTING UP WINCHESTER PARTITIONS 

A problem occurs when XENIX partitions are set up on Winchester 
disk drives. A special area of each Winchester disk drive is reserved for 
diagnostic information. XENIX 2.1.3A allows this area to be included 
in a XENIX partition. Doing this can result in either an excessive 
number of bad tracks being found during the XENIX bad track scan or 
the diagnostic bad track map ( not the XENIX bad track map) being 
overwritten. 

To prevent these problems, you need to set up your XENIX partition 
to avoid this diagnostic area. The last track that should be used varies 
depending on the Winchester type as shown in the following table: 


Winchester Type 

Last Available Track 

21 MB 

2455 

40 MB 

4619 

72 MB 

8315 

120 MB 

13754 


When installing XENIX, do not select option 2, use Entire Disk 
for XENIX, Instead, use option 3, Create XENIX partition, and 
create a partition that does not extend past the last available track for 
your Winchester type. 


XENIX is a registered trademark of Microsoft Corporation. 


This Document: 2548869-0001 


Release Notes Addendum 1 


fter you have created a XENIX partition, a table similar to the fol- 
ding is displayed. 


Partition 

Status 

Type 

Start 

End 

Size 

1 

Inactive 

XENIX 

1 

8315 

8315 


Verify that the End track number does not exceed the last available 
track for your Winchester type. If it does, delete the XENIX partition 
and re-create it. After creating the XENIX partition, activate it using 
option 4, Activate Partition, before continuing with the XENIX 
t installation. 
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